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得 实录 520 分 钟 、91 个 外 设 开 发 高 清 学 习 视 频 
W 11 个 大 型 综合 案例 ， 与 实际 外 设 开发 项 目 可 无 颖 对 接 。 
帝 从 内 核 分 析 到 接口 实现 ， 完 整 再 现 一 个 个 经 典 外 设 项 目的 开发 全 程 。 
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内 容 简介 


Android 系统 从 诞生 到 现在 ， 短 短 几 年 便 凭 借 其 操作 易 用 性 和 开发 的 简洁 性 ， 赢 得 了 广大 用 户 和 开发 者 的 支持 。 截 
Æ 2014 +9 H 30 Н, Android 系统 的 市 场 占有 率 高 达 85%。 本 书 内 容 分 为 3 篇 ， 共 计 19 章 ， 循 序 渐进 地 讲解 了 开发 
Android 外 设 项 目的 基本 知识 。 本 书 从 获取 源码 和 搭建 应 用 开发 环境 开始 讲 起 ， 依 次 讲解 了 基础 知识 、 系 统 分 析 和 实战 
演练 3 部 分 的 内 容 。 在 讲解 每 一 个 知识 点 时 ， 都 遵循 了 理论 联系 实际 的 讲解 方式 ， 从 内 核 分 析 到 接口 API 实现 ， 再 到 实 
战 演练 ， 最 后 到 综合 实例 演练 ， 彻 底 剖析 了 一 个 个 经 典 外 设 的 完整 实现 流程 。 本 书 几 乎 涵盖 了 所 有 Android 外 设 项 目 开 
发 的 主要 内 容 ， 讲 解 通俗 易 懂 并 且 详细 ， 不 但 适合 应 用 高 手 的 学 习 ， 也 特别 有 利于 初学 者 学 习 和 掌握 。 

本 书 适合 Android 驱动 开发 者 、Linux 开发 人 员 、Android 物 联网 开发 人 员 、Android 编程 爱好 者 、Android 源码 分 
HAR, Android 应 用 开发 人 员 、Android 传感器 开发 人 员 、Android 智能 家 居 开发 人 员 、Android 可 穿戴 设备 开发 人 员 
的 学 习 ， 也 可 以 作为 相关 培训 机 构 和 大 专 院 校 相 关 专 业 的 教学 用 书 。 
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前 


2007 年 11 H 5 日 ,， 谷歌 公司 宣布 的 基于 Linux 平台 的 开源 手机 操作 系统 Android 诞生 ， 该 平台 号 
称 是 首 个 为 移动 终端 打造 的 真正 开放 和 完整 的 移动 软件 。 本 书 将 和 广大 读者 一 起 共同 领略 这 款 系统 的 
神奇 之 处 。 


市 场 占有 率 高 居 第 一 


截至 2014 9 H, Android 在 手机 市 场 上 的 占有 率 从 2013 年 的 68.8% 上 升 到 85%。 从 数据 上 看 ， 
Android 市 场 的 占有 率 增加 幅度 较 大 ，WP 市 场 小 幅 增长 ， 但 105 却 有 所 下 降 。Android 平台 占据 了 市 
场 的 主导 地 位 ， 继 续 充当 老大 的 角色 。 

就 目前 来 看 ， 智 能 手机 的 市 场 已 经 饱和， 大 多 数 人 都 在 各 个 平台 中 转换 。 而 就 在 这 样 一 个 市 场 上 ， 
Android 还 增长 了 10% 左 右 的 占有 率 确实 不 易 。 


为 开发 人 员 提 供 了 成 长 的 “沃土 ” 


(1) 保证 开发 人 员 可 以 迅速 转型 为 Android 应 用 开发 
Android 应 用 程序 是 通过 Java 语言 开发 的 ， 只 要 具备 Java 开发 基础 ， 就 能 很 快 地 上 手 并 掌握 。 作 
为 单独 的 Android 应 用 开发 ， 对 Java 编程 门槛 的 要 求 并 不 高 ， 即 使 没有 编程 经 验 的 生 手 ， 也 可 以 在 突 
击 学 习 Java 之 后 容易 地 学 习 Android. 
(2) 定期 召开 奖金 丰厚 的 Android 大 赛 
为 了 吸引 更 多 的 用 户 使 用 Android 开发 ， 谷 歌 已 经 成 功 举办 了 奖金 为 数 千 万 美元 的 开发 者 竞赛 ， 
鼓励 开发 人 员 研发 出 创意 十 足 、 十 分 有 用 的 软件 。 
(3) 开发 人 员 可 以 利用 自己 的 作品 赚钱 
为 了 能 让 Android 平台 吸引 更 多 的 关注 ， 谷 歌 提 供 了 一 个 专门 下 载 Android 应 用 的 门店 : Android 
Market， 地 址 是 https://play.google.com/store。 该 门店 允许 开发 人 员 发 布 应 用 程序 ， 也 允许 Android 用 户 
下 载 自己 喜欢 的 程序 。 作 为 开发 者 ， 需 要 申请 开发 者 账号 ， 申 请 后 才能 将 自己 的 程序 上 传 到 Android 
Market， 并 且 可 以 对 自己 的 软件 进行 定价 。 


本 书 的 内 容 
本 书 内 容 分 为 3 篇， 共计 19 章 ， 循 序 渐进 地 讲解 了 开发 Android 外 设 项 目的 基本 知识 。 本 书 依次 


讲解 了 Android 系统 、 获 取 并 编译 Android 源码 、 搭 建 Android 应 用 开发 环境 、Android 核心 框架 、Android 
传感器 系统 架构 、 蓝 牙 系统 、NFC 近 场 通信 、Google Now 和 Android Wear、 暴 走 轨 迹 计 步 器 、 智 能 家 


jid 外 设 开发 实战 


居 系统 、 智 能 心率 计 、 湿 度 测试 仪 、 小 米 录音 机 、 智 能 楼 宇 灯光 控制 系统 、 智 能 闹钟 系统 、 开 发 一 个 
音乐 播放 器 、 移 动 阅读 器 系统 、QR 码 采集 器 和 骑 行 记录 仪 等 知识 。 


本 书 的 版 本 


Android 系统 自 2008 年 9 月 发 布 第 一 个 版 本 1.1 至 2014 年 10 月 发 布 最 新 版 本 5.0， 一 共存 在 十 
多 个 版 本 。 由 此 可 见 ，Android 系统 升级 频率 较 快 ， 一 年 之 中 最 少 有 两 个 新 版 本 诞生 。 但 如 果 过 于 追 
求 新 版 本 ， 会 造成 力不从心 的 结果 ， 所 以 在 此 建议 广大 读者 :“ 不 必 追 求 最 新 的 版 本 ， 我 们 只 需 关 
注 最 流行 的 版 本 即 可 ” 据 官 方 统计 ,截至 2014 年 10 月 25 日 ,占据 前 3 位 的 版 本 分 别 是 Android 4.3、 
Android 4.4 和 Android 4.2， 其 实 这 3 个 版 本 的 区 别 并 不 是 很 大 ， 只 是 在 某 领域 的 细节 上 进行 了 更 新 。 
为 了 及 时 体验 Android 系统 的 最 新 功能 , 本 书 中 使 用 的 版 本 是 目前 (本 书 成 稿 时 ) 最 新 的 版 本 Android 5.0。 


本 书 特色 


本 书 内 容 十 分 丰富 ， 并 且 讲 解 细致 。 我 们 的 目标 是 通过 一 本 图 书 ， 提 供 多 本 图 书 的 价值 ， 读 者 可 
以 根据 自己 的 需要 有 选择 地 阅读 。 在 内 容 的 编写 上 ， 本 书 具有 以 下 特色 。 

CD 内 容 全 面 ， 讲 解 细致 

本 书 几 乎 涵盖 了 开发 Android 项 目 所 需要 的 所 有 主要 知识 点 ， 详 细 讲 解 了 每 一 个 典型 外 设 项 目的 
实现 过 程 和 具体 移植 方法 。 每 一 个 知识 点 都 力求 用 详实 和 易 懂 的 语言 展现 在 读者 面前 。 

(2) 遵循 合理 的 主线 进行 讲解 

为 了 使 广大 读者 彻底 弄 清楚 Android 外 设 项 目 开发 的 各 个 知识 点 ,在 讲解 每 一 个 知识 点 时 , 从 Linux 
内 核 开 始 讲 起 ， 依 次 剖析 了 底层 架构 、API 接口 连接 和 具体 应 用 的 知识 。 遵 循 了 从 底层 到 顶层 ， 实 现 
了 外 设 项 目 开 发 大 揭秘 的 目标 。 

(3) 章节 独立 ， 自 由 阅读 

本 书 中 的 每 一 章 内 容 都 可 以 独自 成 书 ， 读 者 既 可 以 按照 本 书 编排 的 章节 顺序 进行 学 习 ， 也 可 以 根 
据 自己 的 需求 对 某 一 章节 进行 针对 性 的 学 习 ， 并 且 和 传统 古板 的 计算 机 书籍 相 比 ， 阅 读本 书 会 带 来 很 
大 的 快乐 。 

(4) 实例 典型 ， 实 用 性 强 

本 书 讲解 了 实际 应 用 中 最 典型 外 设 系统 的 实现 方法 和 架构 技巧 ， 这 些 外 设 应 用 都 是 在 商业 项 目 中 
最 需要 的 部 分 。 读 者 可 以 直接 将 本 书 中 介绍 的 知识 应 用 到 自己 的 项 目 中 ， 实 现 无 颖 对 接 。 

(5) 附 配 资源 丰富 

本 书 配 有 丰富 的 学 习 资源 ， 除 源 代 码 、PPT 之 外 ， 还 实录 了 91 个 高 清 学 习 视 频 ， 既 有 实用 的 知识 点 
讲解 视频 ， 也 有 详细 的 实例 开发 视频 ， 全 面 、 深 入 、 细 致 地 解析 Android 外 设 开发 的 方方面面 。 除 此 以 
外 ， 本 书 额外 赠送 了 38 个 Android 应 用 开发 学 习 视频 ， 以 及 15 个 Android 应 用 开发 综合 案例 ， 包 括 仿 
小 米 录音 机 、 音 乐 播放 器 、 跟 踪 定 位 系统 、 仿 陌 陌 交友 系统 、 手 势 音乐 播放 器 、 智 能 家 居 系 统 、 湿 度 测 
试 仪 、 象 棋 游 戏 、 抢 滩 登 陆游 戏 、 九 宫 格 数 独 游 戏 、 健 康 饮食 系统 、 仓 库 管 理 系统 、 个 人 财务 系统 、 仿 
去 哪儿 酒店 预定 系统 、 仿 开心 网 客户 端 等 。 通 过 这 些 附 配 资源 ， 读 者 的 学 习 过 程 会 更 加 方便 、 快 捷 。 


e 


读者 对 象 


本 书 适 合 初学 Android 编程 的 自学 者 、Android 驱动 开发 者 、Linux FRAR, Android 物 联网 开发 
人 员 、Android 编程 爱好 者 、Android 源码 分 析 人 员 、Android 应 用 开发 人 员 、Android 传感器 开发 人 员 、 
Android 智能 家 居 开 发 人 员 、Android 可 穿戴 设备 开发 人 员 学 习 ， 也 可 以 作为 相关 培训 学 校 和 大 专 院 校 
相关 专业 的 教学 用 书 。 

参与 本 书 编写 的 人 员 还 有 周秀 、 付 松柏 、 邓 才 兵 、 钟 世 礼 、 谭 贞 军 、 张 加 春 、 王 教 明 、 万 春 潮 、 
郭 慧玲 、 侯 恩 静 、 程 娟 、 王 文忠 、 陈 强 、 何 子夜 、 李 天 祥 、 周 锐 、 朱 桂 英 、 张 元 亮 、 张 韶 青 、 秦 丹 枫 。 

本 书 在 编写 过 程 中 ， 得 到 了 清华 大 学 出 版 社工 作 人 员 的 大 力 支 持 ， 正 是 各 位 编辑 的 求实 、 耐 心地 
付出 ， 才 能 使 得 本 书 在 较 短 的 时 间 内 出 版 。 另 外 也 十 分 感谢 我 们 的 家 人 ， 在 写作 本 书 的 时 候 给 予 了 巨 
大 支持 。 由 于 本 书 编 写 团队 成 员 水 平 有 限 ， 丝 漏 和 不 尽 如 人意 之 处 在 所 难免 ， 诚 请 读者 提出 意见 或 建 
议 ， 以 便 修订 并 使 之 更 到 完 善 。 另 外 我 们 提供 了 售后 支持 网 站 (http://www.chubanbook.com/) 和 QQ 
FE (192153124) ， 读 者 朋友 如 有 疑问 可 以 在 此 提出 ， 一 定 会 得 到 满意 的 答复 。 
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第 1 音 Android 系统 介绍 


2007 Æ, Google 公司 推出 了 一 款 无 与 伦比 的 移动 智能 设备 系统 一 一 Android， 这 是 一 种 建立 在 Linux 
基础 之 上 的 为 手机 、 平 板 等 移动 设备 提供 的 软件 解决 方案 。 截 至 2014 年 , Android 系统 的 占有 率 高 达 85%, 
已 经 成 为 了 当今 最 受 欢迎 的 智能 设备 系统 之 一 。 本 章 将 引领 读者 一 起 来 了 解 Android 系统 的 发 展 历程 和 
背景 ， 充 分 体验 这 款 操作 系统 的 成 功 之 处 。 


1.1 纵览 主流 智能 设备 系统 


GM 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 1 章 \ 纵 览 主流 智能 设备 系统 .avi 

在 当今 市 面 中 有 很 多 智能 设备 系统 ， 特 别 是 在 移动 智能 设备 领域 。 在 Android 系统 推出 之 前 ， 塞 
班 、 苹 果 和 微软 在 移动 智能 系统 领域 互 不 相让 ， 三 足 易 立 之 势 日 渐 明 朗 。 在 本 节 的 内 容 中 ， 将 一 一 讲 
解 市 面 中 主流 的 智能 系统 。 


1.1.1 昨日 王者 一 一 Symbian 〈 塞 班 ) 


Symbian 作为 昔日 智能 手机 的 王者 ， 在 2005 年 至 2010 年 曾 一 度 风行 ， 人 们 手中 拿 的 很 多 都 是 诺 
基 亚 的 Symbian 手机 , N70 一 N73 一 N78 一 N97, 诺基亚 N 系列 曾经 被 称 为 “N= 
无 限 大 ”的 手机 。 对 硬件 要 求 低 ， 操 作 简单 ， 省 电 ， 软 件 资源 多 ， 是 Symbian symbian 
系统 手机 的 重要 特点 ， 如 图 1-1 所 示 。 05 

在 国内 软件 开发 市 场 内 ， 基 本 每 一 个 软件 都 会 有 对 应 的 塞 班 手机 版 本 。 
而 塞 班 开发 之 初 的 目标 是 要 保证 在 较 低 资源 的 设备 上 能 长 时 间 稳 定 可 靠 地 运 
行 ， 这 导致 了 塞 班 的 应 用 程序 开发 有 着 较为 陡峭 的 学 习 曲 线 ， 开 发 成 本 较 高 ， 但 是 程序 的 运行 效率 很 
高 。 比 如 5800 的 128MB 的 RAM， 后 台 可 以 同时 运行 十 几 个 程序 而 操作 流畅 (多 任务 功能 是 特别 强大 
的 )， 即 使 几 天 不 关机 它 的 剩余 内 存 也 能 保持 稳定 。 

虽然 在 Android, iOS 的 围攻 之 下 ,诺基亚 推出 了 塞 班 3 系统 ， 甚 至 依然 为 其 更 新 (Symbian Аппа, 
Symbian Belle)， 从 外 在 的 用 户 界面 到 内 在 的 功能 特性 都 有 了 显著 提升 ， 例 如 可 自由 定制 的 全 新 窗 体 部 
件 、 更 多 主屏 、 全 新 下 拉 式 菜单 等 。 

由 于 对 新 兴 的 社交 网 络 和 Web 2.0 内 容 支 持 欠 佳 ， 塞 班 占 智能 手机 的 市 场 份 额 日 益 萎缩 。2010 年 
Ж, 其 市 场 占有 量 已 被 Android 超过 。 自 2009 ERFA, 包括 摩 托 罗拉 、 三 星 电子 、LG、 索 尼 爱 立信 
等 各 大 厂商 纷纷 宣布 终止 塞 班 平台 的 研发 ， 转 而 投入 Android 领域 。2011 年 初 ， 诺 基 亚 宣布 将 与 微软 
成 立 战略 联盟 ， 推 出 基于 Windows Phone 的 智能 手机 ， 从 而 在 事实 上 放弃 了 经 营 多 年 的 塞 班 ， 塞 班 退 
市 已 成 定局 。 


1-1 Symbian 系统 


яте лшюайййа О 


1.1.2 ”高 贵 华丽 一 一 iOS 


105 作为 苹果 移动 设备 iPhone 和 iPad 的 操作 系统 ( 见 图 1-2)， 在 App Store 的 推动 之 下 ， 成 为 了 
世界 上 引领 潮流 的 操作 系统 之 一 。 原 本 这 个 系统 名 为 iPhone OS， 直 到 2010 年 6 月 7 日 WWDC 大 会 
上 宣布 改名 为 0S. 105 的 用 户 界面 的 概念 基础 是 能 够 使 用 多 点 触 控 直 接 操作 。 控 制 方法 包括 滑动 、 轻 
触 开 关 及 按键 。 与 系统 交互 包括 滑动 (Swiping)、 轻 按 (Tapping)、 挤 压 〈Pinching， 通 常用 于 缩小 ) 
及 反 向 挤 压 (Reverse Pinching or Unpinching， 通 常用 于 放大 )。 此 外 ， 通 过 其 2 
自 带 的 加 速 器 ， 可 以 令 其 旋转 设备 改变 其 y 轴 ， 以 令 屏幕 改变 方向 ， 这 样 的 设 X 
it iPhone 更 便于 使 用 。 V \ 
Q 最 早 iPhone OS 1.0: 内 置 于 iPhone 一 代 手 机 里 ,借助 iPhone 流 畅 的 触摸 Ñ ) 
BUE, iPhone OS 给 用 户 带 来 了 极为 优秀 的 使 用 体验 , 相 比 当时 的 手机 O 
可 以 用 售 艳 来 形容 。 по ios 操作 系统 标志 
Q iPhone OS 2.0: 随 iPhone 3G 发 布 ，App Store 诞 生 。App Store 为 第 三 方 
软件 的 提供 者 提供 了 方便 而 又 高 效 的 一 个 软件 销售 平台 , 在 软件 开发 者 与 最 终 用 户 之 间架 起 了 
一 座 沟通 与 销售 的 桥梁 ， 从 而 极 大 地 丰富 了 iPhone 手机 功能 应 用 。 

口 iPhone OS 3.0: iPhone 3G 开 始 支持 复制 粘贴 。 

О 105 4: 在 iPhone 4 推出 的 时 候 ， 苹 果 决 定 将 原来 iPhone OS 系统 重新 定名 为 iOS， 并 发 布 新 一 代 

操作 系统 iOS 4。 在 这 个 版 本 里 ， 开 始 正式 支持 多 任务 功能 ， 通 过 双击 HOME 键 实现 。 

O 1055: 加 入 了 Siri 语 音 操作 助手 功能 ， 用 户 可 以 与 手机 实现 语言 上 的 人 机 交互 ， 该 功能 可 以 实 

现 对 用 户 的 语音 识别 ， 完 成 一 些 较为 复杂 的 操作 ， 使 用 Siri 来 查询 天 气 、 进 行 导航 、 询 问 时 间 、 
设 定 闹钟 、 查 询 股票 甚至 发 送 短信 等 功能 ， 方 便 了 用 户 的 使 用 。 

从 最 初 的 iPhone OS， 演 变 至 最 新 的 iOS 系统 ，iOS 成 为 了 苹果 新 的 移动 设备 操作 系统 ， 横 跨 iPod 
Touch、iPad、iPhone， 成 为 苹果 最 强大 的 操作 系统 ， 甚 至 新 一 代 的 Mac OS X Lion 也 借鉴 了 105 系统 
的 一 些 设计 ， 可 以 说 iOS 是 苹果 的 又 一 个 成 功 的 操作 系统 ， 给 用 户 带 来 了 极 佳 的 使 用 体验 。 

由 于 其 优秀 的 系统 设计 以 及 严格 的 App Store，iOS 作为 应 用 数量 最 多 的 移动 设备 操作 系统 ， 加 上 
强大 的 硬件 支持 以 及 最 新 iOS 5 内 置 的 Siri 语音 助手 , 无 疑 使 得 用 户 体验 得 到 了 更 大 的 提升 , 感受 科技 
带 来 的 好 处 。 


1.1.3 ”全 新 面貌 一 Windows Phone 


早 在 2004 年 时 , 微软 就 开始 以 “Photon” 的 计划 代号 开始 研发 Windows Mobile 的 一 个 重要 版 本 更 
新 。 直 到 2008 年 ,在 iOS 和 Android 的 巨大 冲击 之 下 ， 微 软 重新 组 织 了 Windows Mobile 的 小 组 ， 并 
继续 开发 一 个 新 的 行动 操作 系统 。 

Windows Phone, 简称 WP, 是 微软 发 布 的 一 款 手机 操作 系统 ( 见 图 1-3), 它 将 微软 旗下 的 Xbox Live 
游戏 、Xbox Music 音乐 与 独特 的 视频 体验 集成 到 手机 中 。 微 软 公 司 于 2010 年 10 H 11 日 晚上 9 30 
分 正式 发 布 了 智能 手机 操作 系统 Windows Phone， 并 将 其 使 用 接口 称 为 “Modern ”接口 。2011 年 2 H, 
诺基亚 与 微软 达成 全 球 战略 同盟 并 深度 合作 共同 研发 .2011 年 9 月 27 日 ,微软 发 布 Windows Phone 7.5. 
2012 年 6 月 21 日 ， 微 软 正式 发 布 Windows Phone 8， 采 用 和 Windows 8 相同 的 Windows NT 内 核 ， 同 
时 也 针对 市 场 的 Windows Phone 7.5 发 布 Windows Phone 7.8。 现 有 Windows Phone 7 手机 都 将 无 法 升级 
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Android 外 设 开发 实 成 


至 Windows Phone 8。 如 图 1-4 所 示 为 诺基亚 Windows Phone 手机 界面 。 


El Windows Phone 
[Л Windows Phone 
[Л] Windows Phone 
[Л Windows Phone 
1-3 Windows Phone 操作 系统 标志 1-4 Windows Phone 手机 界面 


Windows Phone ЖЯ ЖШ ЕЙ, BRER tab Pel — AAT DAR EAS. HE ERR 
供 类 似 仪表 盘 的 体验 来 显示 新 的 电子 邮件 、 短 信 、 未 接 来 电 、 日 历 约会 等 ， 让 人 们 对 重要 信息 保持 
时 刻 更 新 。 它 还 包括 一 个 增强 的 触摸 屏 界面 ， 更 方便 手指 操作 ;以 及 一 个 最 新 版 本 的 TE Mobile 浏览 
器 一 一 该 浏览 器 在 一 项 由 微软 赞助 的 第 三 方 调查 研究 中 ， 和 参与 调研 的 其 他 浏览 器 和 手机 相 比 ， 可 以 
执行 指定 任务 的 比例 超过 48%。 很 容易 看 出 微软 在 用 户 操作 体验 上 所 作出 的 努力 ， 而 史 蒂 夫 。 鲍 尔 默 
也 表示 :“ 全 新 的 Windows 手机 把 网 络 、 个 人 电脑 和 手机 的 优势 集 于 一 身 ， 让 人 们 可 以 随时 随地 享受 
到 想 要 的 体验 。” 

Windows Phone， 力 图 打破 人 们 与 信息 和 应 用 之 间 的 隔 闵 ， 提 供 适 用 于 人 们 包括 工作 和 娱乐 在 内 完 
整 生活 的 方方面面 ， 是 最 优秀 的 端 到 端 体验 。 


1.1.4 ”高 端 商务 一 一 BlackBerry OS 〈 黑 莓 ) 


BlackBerry 系统 ， 即 黑莓 系统 〈 见 图 1-5)， 是 加 拿 大 Research In Motion (简称 RIM) 公司 推出 的 
一 种 无 线 手 持 邮件 解决 终端 设备 的 操作 系统 ， 由 RIM 自主 开发 。 它 和 其 他 手机 终端 使 用 的 Symbian、 
Windows Mobile, iOS 等 操作 系统 有 所 不 同 ，BlackBerry 系统 的 加 密 性 能 更 强 ， 更 安全 。 


*:: BlackBerry. 
1-5 BlackBerry 系统 标志 


安装 有 BlackBerry 系统 的 黑莓 机 , 不 单单 是 指 一 台 手机 , 而 是 由 RIM 公司 所 推出 , 包含 服务 器 ( 邮 
件 设 定 )、 软 件 〈 操 作 接 口 ) 以 及 终端 手机) 大 类 别 的 Push Май 实时 电子 邮件 服务 。 

“MRE” (BlackBerry) 移动 邮件 设备 基于 双向 寻 呼 技术 。 该 设备 与 RIM 公司 的 服务 器 相 结合 ， 依 
赖 于 特定 的 服务 器 软件 和 终端 兼容 现 有 的 无 线 数据 链 路 ， 实 现 了 遍及 北美 、 随 时 随地 收发 电子 邮件 
的 梦想 。 这 种 装置 并 不 以 奇妙 的 图 片 和 彩色 屏幕 夺 人 耳目 ， 甚 至 不 带 发 声 器 。“9。11” 事 件 之 后 ， 由 
于 BlackBerry 及 时 传递 了 灾难 现场 的 信息 ， 而 在 美国 掀起 了 拥有 一 部 BlackBerry 终端 的 热潮 。 

黑莓 赖 以 成 功 的 最 重要 原则 一 一 针对 高 级 白领 和 企业 人 士 ， 提供 企业 移动 办 公 的 一 体 化 解决 方案 。 
企业 有 大 量 的 信息 需要 即时 处 理 ， 出 差 在 外 时 ， 也 需要 一 个 无 线 的 可 移动 的 办 公设 备 。 企 业 只 要 装 一 
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第 1 章 Android 系统 介绍 


个 移动 网 关 ， 一 个 软件 系统 ， 用 手机 的 平台 实现 无 缝 链接， 无论 何 时 何 地 ， 员 工 都 可 以 用 手机 进行 办 
公 。 它 最 大 的 方便 之 处 是 提供 了 邮件 的 推送 功能 : 即 由 邮件 服务 器 主动 将 收 到 的 邮件 推送 到 用 户 的 手 
持 设备 上 ， 而 不 需要 用 户 频繁 地 连接 网 络 查看 是 否 有 新 邮件 。 

黑 芝 系统 稳定 性 非常 优秀 ， 其 独特 定位 也 深 得 商务 人 士 所 青 上 昧 。 可 是 也 因此 在 大 众 市 场 上 得 不 到 
优势 ， 国 内 用 户 和 应 用 资源 也 较 少 。 


背景 说 明 


(1) 2010 年 9 月 ， 诺 基 亚 宣布 将 从 2011 年 4 月 起 从 Symbian 基金 会 Symbian Foundation) 手中 收回 Symbian 操作 系 
统 控制 权 。 由 此 看 来 ， 诺 基 亚 在 2008 年 全 资 收购 塞 班 公司 之 后 希望 继续 扩大 塞 班 影响 力 的 愿望 并 没有 实现 。 

(2) 在 苹果 和 Android 的 强大 市 场 攻 势 下 ,诺基亚 在 2011 年 2 月 11 日 宣布 与 微软 达成 广泛 战略 合作 关系 ,并 将 Windows 
Phone 作为 其 主要 的 智能 手机 操作 系统 。 这 家 芬兰 手机 巨头 试图 通过 结盟 捏 转 闫 势 。 

(3) 2011 年 8 月 15 日 ,谷歌 和 摩托 罗拉 移动 公司 共同 宣布 ,谷歌 将 以 每 股 40.00 美元 现金 收购 摩托 罗拉 移动 ， 总 额 约 
125 亿美 元 ， 相 比 摩托 罗拉 移动 股份 的 收盘 价 溢价 了 63%， 双 方 董事 会 都 已 全 票 通过 该 交易 。 谷歌 CEO 拉 里 : 佩 
奇 表示 ， 摩 托 罗拉 移动 完全 专注 于 Android 系统 ， 收 购 摩托 罗拉 移动 之 后 ， 将 增强 整个 Android 生态 系统 。 佩 奇 
同时 表示 ，Android 将 继续 开源 ， 收 购 的 一 个 目的 是 为 了 获得 专利 。 

(4) 2013 年 9 月 3 日 ， 微 软 公司 今日 宣布 将 以 37.9 亿 欧 元 的 价格 收购 诺基亚 的 设备 和 服务 部 门 ， 同 时 还 将 以 16.5 亿 
欧元 的 价格 收购 诺基亚 的 相关 技术 专利 ， 本 次 交易 总 额 达到 54.4 亿 欧元 ， 其 中 有 3.2 万 名 员工 将 从 诺基亚 转 入 微 
软 ， 整 笔 交 易 预 计 将 于 2014 年 第 一 季度 完成 。 

(5) 2013 年 9 月 24 日 消息 ， 黑 蓄 表 示 已 经 与 由 Fairfax Financial Holdings 主导 的 财团 达成 交易 ， 准 备 以 47 亿美 元 出 售 ， 
但 是 后 来 没有 任何 爆炸 性 消息 发 布 。 


1.1.5 本 书 的 主角 一 一 Android 


Android 一 词 最 早出 现 于 法 国 作家 利 尔 * 亚当 (Auguste Villiers de l'Isle-Adam) 在 1886 年 发 表 的 
科幻 小 说 《未 来 夏娃 》(L’eve Future) 中 ， 他 将 外 表 像 人 的 机 器 起 名 为 Android， 如 图 1-6 所 示 。 

2008 年 HTC 和 Google 联手 推出 了 第 一 台 Android 手机 G1，2014 年 10 月 15 日 

(美国 太平 洋 时 间 )，Google 公司 发 布 了 全 新 的 Android 操作 系统 : Android 5.0. 

北京 时 间 2014 年 6 月 26 日 0 时 ,Google 1/0 2014 开发 者 大 会 在 旧金山 正式 召开 ， 
ЖАП Y Android 5.0 的 前 身 L (Lollipop) 版 Android 开发 者 预览 版 本 。2014 年 的 三 款 aa PELD] 
新 Nexus 设备 一 Nexus 6, Nexus 9 平板 及 Nexus Player 将 率先 搭载 Android 5.0, 
之 前 的 Nexus 5. Nexus 7 及 Nexus 10 将 会 很 快 获得 更 新 ， 而 Google Play 版 设 
备 则 需要 等 上 几 周 才能 升级 。 

从 2011 年 第 一 季度 开始 ，Android 在 全 球 的 市 场 份额 首次 超过 塞 班 系统 ， 跃 居 全 球 第 一 。2014 年 
8 H 15 H, 根据 IDC 发 布 的 2014 年 第 二 季度 智能 手机 市 场 的 最 新 数据 显示 ,苹果 iOS 和 谷歌 Android 
两 大 系统 平台 继续 领跑 。Android 阵营 增长 则 更 惊人 , 达到 了 33.396, 出 货 量 达到 了 2.553 亿 台 。Android 
系统 的 市 场 份额 得 到 了 提高 , 从 2013 年 第 二 季度 的 79.6% 增 长 到 了 2014 年 第 二 季度 的 84.7%。 具体 信 
息 如 图 1-7 所 示 。 

由 此 可 见 ，Android 系统 的 市 场 占 有 率 位 居 第 一 ， 并 且 毫 无 压力 。Android 机 型 数量 庞大 ， 简 单 易 
用 ,相当 自由 的 系统 能 让 厂商 和 客户 轻松 地 定制 各 种 ROM， 以 及 各 种 桌面 部 件 和 主题 风格 。 其 简单 而 
华丽 的 界面 得 到 了 广大 客户 的 认可 ， 对 手机 进行 刷机 也 是 不 少 Android 用 户 所 津津 乐 道 的 事情 。 
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图 1-6 Android 标志 


Top Five Smartphone Operating Systems, Worldwide Shipments, and 
Market Share, 201402 (Units in Millions) - IDC/Applelnsider 
022014 022014 Q22013 02 2013 Year- 
Shipment Market Shipment Market Over-Year 
Volume Share Volume Share Growth 
Operating System 


Android 255.3 847% 191.5 796% 33.3% 
105 352 11.7% 31.2 13.0% 12.7% 
Windows Phone 74 2.5% 82 3.4% -9.4% 
BlackBerry 15 0.5% 67 2.8% -78.0% 
Others 19 06% 29 1.2% -32.2% 
Total 301.3 100.0% 240.5 100.0% 25.3% 


图 1-7 2014 年 8 月 智能 手机 平台 调查 表 


可 惜 Android 版 本 数量 较 多 ， 市 面 上 同时 存在 着 1.6、2.0、2.1、2.2、2.3、4.4.2、5.0 等 各 种 版 本 
的 Android 系统 手机 ， 应 用 软件 对 各 版 本 系统 的 兼容 性 对 程序 开发 人 员 是 一 个 不 小 的 挑战 。 同 时 由 于 
开发 门槛 低 ， 导 致 应 用 数量 虽然 很 多 ， 但 是 应 用 质量 参差 不 齐 ， 甚 至 出 现 不 少 恶意 软件 ， 导 致 一 些 用 
户 受到 损失 。 同 时 Android 没有 对 各 厂商 在 硬件 上 进行 限制 ， 导 致 一 些 用 户 在 低 端 机 型 上 体验 不 佳 。 
另 一 方面 ， 因 为 Android 的 应 用 主要 使 用 Java 语言 开发 ， 其 运行 效率 和 硬件 消耗 一 直 是 其 他 手机 用 户 
所 诉 病 的 地 方 。 


1.2 ”分析 Android 成 功 的 秘诀 


GEO 知识 点 讲解 : 光盘: 视频 \ 知 识 点 \ 第 1 章 \ 分 析 Android 成 功 的 秘诀.avi 
从 2007 年 诞生 ， 到 2014 年 占据 市 场 85% 的 份额 ， 为 什么 Android 系统 能 够 在 这 么 短 的 时 间 内 成 
为 移动 智能 设备 市 场 占有 率 的 第 一 名 ? 在 本 节 的 内 容 中 ， 将 从 4 个 方面 来 为 读者 解答 这 个 问题 。 


1.2.1 ” 强 有 力 的 业界 支持 


Android 系统 基于 Linux 内 核 ， 是 一 款 开源 的 手机 操作 系统 。 正 是 因为 如 此 ， 在 Android ЇЙЇ Ж 
头角 之 后 ， 各 大 手机 厂商 和 电信 部 门 纷纷 加 入 到 了 Android 联盟 当中 。Android 联盟 由 业界 内 的 世界 级 
企业 组 成 ， 主 要 成 员 包 括 中 国 移动 、 摩 托 罗拉 、 高 通 、T-Mobile、 三 星 、LG、HTC 等 在 内 的 30 多 家 
技术 和 无 线 应 用 的 领军 企业 。Android 通过 与 运营 商 、 设 备 制造 商 、 开 发 商 和 其 他 有 关 各 方 结 成 深层 次 
的 合作 伙伴 关系 ， 希 望 借助 建立 标准 化 、 开 放 式 的 移动 电话 软件 平台 ， 在 移动 产业 内 形成 一 个 开放 式 
的 生态 系统 。 


122 ”研发 阵容 强大 


Android 的 研发 队伍 阵容 强大 ， 包 括 摩托 罗拉 、Google、HTC (宏达电 子 )、PHILIPS、TMobile、 
高 通 、 魅 族 、 三 星 、LG 以 及 中 国 移动 在 内 的 34 家 企业 ， 这 一 个 个 响亮 的 名 字 都 在 业界 内 堪 称 大 化 。 
他 们 都 将 基于 该 平台 开发 手机 的 新 型 业务 ， 应 用 之 间 的 通用 性 和 互联 性 将 在 最 大 程度 上 得 到 保持 。 
无 论 是 从 硬件 到 软件 ， 还 是 到 电信 服务 商 ，Android 从 一 开始 便 成 为 了 业界 内 的 宠儿 ， 被 当做 重点 新 
秀 而 培养 。 这 样 Android 系统 在 强大 的 开发 团队 的 培育 和 呵护 下 ， 最 终 顺利 地 功成名就 ， 成 为 了 一 方 
霸主 。 
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яте modena О 


123 ”为 开发 人 员 “ 精 心 定制 ” 


Google 公司 一 直 视 程序 员 为 前 进 动力 的 源泉 ， 为 了 提高 程序 员 们 的 开发 积极 性 ， 不 但 为 开发 人 员 
提供 了 一 流 的 开发 装备 和 软件 服务 ， 而 且 还 提出 了 振奋 人 心 的 奖励 机 制 。 

(1) 保证 开发 人 员 可 以 迅速 转型 为 Android 应 用 开发 

Android 应 用 程序 是 通过 Java 语言 开发 的 ， 只 要 具备 Java 开发 基础 ， 就 能 很 快 地 上 手 并 掌握 。 作 
为 单独 的 Android 应 用 开发 ， 对 Java 编程 门槛 的 要 求 并 不 高 ， 即 使 没有 编程 经 验 的 门外汉 ， 也 可 以 在 
突击 学 习 Java 之 后 学 习 Android。 另 外 ，Android 完全 支持 2D、3D 和 数据 库 ， 并 且 和 浏览 器 实现 了 集 
成 。 所 以 通过 Android 平台 ， 程 序 员 可 以 迅速 、 高 效 地 开发 出 绚丽 多 彩 的 应 用 ， 例 如 常见 的 工具 、 管 
理 、 互 联网 和 游戏 等 。 

(2) 定期 召开 奖金 丰厚 的 Android 大 赛 

为 了 吸引 更 多 的 用 户 使 用 Android FR, Google 已 经 成 功 举 办 了 奖金 为 数 千 万 美元 的 开发 者 竞赛 ， 
鼓励 开发 人 员 研 发 出 创意 十 足 、 十 分 有 用 的 软件 。 这 种 大 赛 对 于 开发 人 员 来 说 ， 不 但 能 练习 自己 的 开 
发 水 平 ， 并 且 高 额 的 奖金 也 是 学 员 们 学 习 的 动力 。 

(3) 开发 人 员 可 以 利用 自己 的 作品 赚钱 

谷歌 提供 了 一 个 专门 下 载 Android 应 用 的 门店 : Android Market， 地 址 是 https://play.google. 
com/store。 在 这 个 门店 里 面 允许 开发 人 员 发 布 应 用 程序 ， 也 允许 Android 用 户 下 载 自己 喜欢 的 程序 。 
作为 开发 者 ， 需 要 申请 开发 者 账号 ， 申 请 后 才能 将 自己 的 程序 上 传 到 Android Market， 并 且 可 以 对 自己 
的 软件 进行 定价 。 只 要 你 的 软件 程序 足够 吸引 人 ， 你 就 可 以 获得 很 好 的 金钱 回报 。 这 样 实现 了 程序 员 
学 习 和 赚钱 两 不 误 ， 所 以 吸引 了 更 多 开发 人 员 加 入 到 Android 大 军 中 来 。 


1.24 开源 


Android 是 一 款 开源 的 系统 ,开源 意味 着 对 开发 人 员 和 手机 厂商 来 说 是 完全 无 偿 免 费 使 用 的 。 正 是 
因为 这 一 原因 ， 所 以 吸引 了 全 世界 各 地 无 数 程序 员 的 热情 。 于 是 很 多 手机 厂商 都 纷纷 采用 Android fE 
为 自己 产品 的 系统 ， 这 当然 也 包括 很 多 山寨 厂商 。 因 为 免费 所 以 降低 了 成 本 ， 提 高 了 利润 。 而 对 于 
开发 人 员 ， 因 为 Android 深 受 众多 移动 设备 产品 所 采用 ， 所 以 这 方面 的 人 才 也 变 得 愈 发 珍贵 。 正 是 因 
HFW, Android 系统 也 被 广大 非 移动 设备 所 采用 ， 例 如 车 载 系统 、 智 能 电视 、 智 能 家 居 、 穿 戴 设 备 等 。 


13 Android 智能 设备 来 歼 


И 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 1 章 \Android 智能 设备 来 袭 .avi 

因为 Android 系统 的 免费 和 开源 , 也 因为 系统 本 身 强大 的 功能 性 , 使 得 Android 系统 不 仅 被 用 于 手 
机 和 平板 设备 上 ， 而 且 也 被 广泛 用 于 其 他 智能 设备 中 ， 例 如 当前 的 新 兴 热点 可 穿戴 设备 。 在 本 节 的 内 
容 中 ， 将 简要 介绍 在 市 面 中 常见 的 搭载 Android 系统 的 智能 设备 。 
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Android 外 设 开发 实战 


1.3.1 常见 的 Android 智能 设备 


(1) 智能 电视 

Android 智能 电视 是 指 搭载 了 安 卓 操 作 系统 的 电视 , 具有 智能 化 , 能 实现 网 页 浏览 、 视 频 电 影 观看 、 
聊天 办 公 游 戏 等 ， 与 平板 电脑 和 智能 手机 一 样 的 功能 。 其 凭借 安 卓 系统 让 电视 实现 智能 化 的 提升 ， 数 
十 万 款 安 卓 市 场 的 应 用 、 游 戏 等 内 容 随意 安装 。 例 如 海尔 的 模 卡 (MOOKA) U42H7030 便 是 一 款 搭载 
Android 4.2 系统 的 智能 电视 ， 如 图 1-8 所 示 。 

(2) BLUE 

Android 机 项 盒 是 指 像 智 能 手机 一 样 ， 具 有 全 开放 式 平台 ， 搭 载 了 安 卓 操作 系统 ， 可 以 由 用 户 自 行 
安装 和 介 载 软件 、 游 戏 等 第 三 方 服务 商 提供 的 程序 ， 通 过 此 类 程序 不 断 对 电视 的 功能 进行 扩充 ， 并 可 
以 通过 网 线 、 无 线 网 络 实现 上 网 冲浪 的 新 一 代 机 顶 盒 总 称 。 

通过 使 用 Android 机 项 盒 ， 可 以 让 电视 具有 上 网 、 看 网 络 视频 、 玩 游戏 、 看 电子 书 、 听 音乐 等 功 
能 ， 使 电视 成 为 一 个 低 成 本 的 平板 电脑 。Android 机 项 盒 ， 不 仅仅 是 一 个 高 清 播放 器 ， 更 具有 一 种 全 新 
的 人 机 交互 模式 ， 既 区 别 于 电脑 ， 又 有 别 于 触摸 屏 ，Android 机 项 盒 配备 红外 感应 条 ， 遥 控 器 一 般 采 用 
空中 飞 鼠 ， 这 样 就 可 以 方便 地 实现 触摸 屏 上 的 各 种 单 点 操作 ， 可 以 方便 地 在 电视 上 玩 愤怒 的 小 鸟 、 植 
物 大 战 僵尸 等 经 典 游 戏 。 例 如 乐 视 公 司 的 Letv 机 项 盒 便 是 基于 Android 打造 的 ， 如 图 1-9 所 示 。 


图 1-8 搭载 Android 4.2 系统 的 智能 电视 图 1-9 基于 Android 的 Letv 机 顶 盒 
(3) 游戏 机 


Android 游戏 机 就 像 Android 智能 手表 一 样 ,在 2013 年 出 现 了 爆炸 式 增 长 在 CES 展会 上 ，NVIDIA 
的 Project Shield 掌上 游戏 主机 以 绝对 震撼 的 姿态 亮相 ,之 后 又 有 Ouya 和 Gamestick 相继 推出 。 不 久 
前 ，Mad Catz 也 发 布 了 一 款 Android 游戏 机 。 
(4) 智能 手表 
智能 手表 ， 是 将 手表 内 置 智能 化 系统 、 搭 载 智 能 手机 系统 而 连接 于 网 络 实现 多 功能 ， 能 同步 手机 
中 的 电话 、 短 信 、 上 邮件、 照片 、 音 乐 等 。2013 年 3 月 媒体 报道 ， 苹 果 、 三 星 、 谷 歌 等 科技 巨头 都 将 在 
2013 年 晚 些 时 候 发 布 智能 手表 。 美 国 市 场 研究 公司 Current Analysis 分 析 师 艾 维 。 格 林 加 特 (Avi 
Greengart) 认为 2013 年 可 能 会 成 为 智能 手表 元 年 。 例 如 LG 宣布 采用 谷歌 Android Wear 操作 系统 开发 
了 一 款 名 为 G Watch 的 智能 手表 ， 该 产品 于 2014 年 第 二 季度 发 布 ， 如 图 1-10 所 示 。 

(5) 智能 家 居 

智能 家 居 是 以 住宅 为 平台 ， 利 用 综合 布线 技术 、 网 络 通信 技术 、 智 能 家 居 - 系 统 设计 方案 安全 防范 
技术 、 自 动 控制 技术 、 音 视频 技术 将 家 居 生 活 有 关 的 设施 集成 ， 构 建 高 效 的 住宅 设施 与 家 庭 日 程 事务 
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的 管理 系统 ， 提 升 家 居 安 全 性 、 便 利 性 、 舒 适 性 、 艺 术 性 ， 并 实现 环保 节能 的 居住 环境 。 

智能 家 居 是 在 互联 网 的 影响 之 下 的 物 联 化 体现 。 智 能 家 居 通 过 物 联网 技术 将 家 中 的 各 种 设备 (如 
音 视频 设备 、 照 明 系 统 、 窗 帘 控 制 、 空 调控 制 、 安 防 系统 、 数 字 影院 系统 、 网 络 家 电 以 及 三 表 抄 送 等 ) 
连接 到 一 起 ， 提 供 家 电 控制 、 照 明 控 制 、 窗 帘 控 制 、 电 话 远程 控制 、 室 内 外 遥控 、 防 盗 报警 、 环 境 监 
测 、 暖 通 控制 、 红 外 转发 以 及 可 编程 定时 控制 等 多 种 功能 和 手段 。 与 普通 家 居 相 比 ， 智 能 家 居 不 仅 具 
有 传统 的 居住 功能 ， 还 兼备 建筑 、 网 络 通信 、 信 息 家 电 、 设 备 自动 化 ， 集 系统 、 结 构 、 服 务 、 管 理 为 
一 体 的 高 效 、 舒 适 、 安 全 、 便 利 、 环 保 的 居住 环境 ， 提 供 全 方位 的 信息 交互 功能 ， 帮 助 家 庭 与 外 部 保 
持 信息 交流 畅通 ， 优 化 人 们 的 生活 方式 ， 帮 助人 们 有 效 安 排 时 间 ， 增 强 家 居 生 活 的 安全 性 ， 甚 至 为 各 
种 能 源 费用 节约 资金 。 

例如 乐得 威 公司 的 GW-9311 智能 主机 产品 便 是 一 款 Android 智能 家 居 产 品 ， 如 图 1-11 所 示 。 


1-10 #4 Android Wear 系统 的 G Watch 1-11 乐得 威 公司 的 GW-9311 智能 主机 


上 述 智能 设备 只 是 冰山 一 角 ， 随 着 物 联网 和 云 服 务 的 普及 和 发 展 ， 将 会 有 更 多 的 智能 设备 诞生 
Android 系统 将 拥有 一 个 更 加 美好 的 未 来 。 


1.3.2 ”新 兴 热 点 一 一 可 穿戴 设备 


最 近 两 年 ， 随 着 Android 和 iOS 系统 的 发 展 ， 可 穿戴 设备 逐渐 展现 在 广大 用 户 的 面前 。 谷 歌 眼镜 、 
苹果 手表 等 新 颖 而 又 时 尚 的 设备 吸引 了 广大 用 户 的 眼球 ， 相 信 在 未 来 这 些 设备 必 将 引领 时 尚 的 潮流 ， 
成 为 科技 界 的 主流 产品 之 一 。 自 从 谷歌 推出 Google 眼镜 产品 之 后 ， 可 穿戴 计算 设备 便 成 为 了 当今 科技 
界 的 火热 话题 之 一 。 在 CES 2013 ACES 2014 (国际 电子 展 ) 上 ， 也 有 不 少 公司 推出 了 眼镜 、 腕 带 等 
各 种 可 穿戴 计算 设备 ， 可 穿戴 计算 也 越 来 越 火热 。 

1. 发 展 背景 

穿戴 设备 看 似 是 一 个 新 兴 事 物 ， 但 实际 上 其 发 展 历史 可 以 上 漳 到 20 世纪 80 年 代 。 多 伦 多 大 学 教 
授 Steve Mann 被 人 称 为 “可 穿戴 计算 之 父 ” 公认 的 第 一 个 赛 博 格 (Cyborg) 一 一 这 是 一 个 特殊 的 群体 ， 
他 们 很 像 科幻 小 说 中 的 一 些 角色 ,利用 机 器 设备 来 增强 自己 的 感觉 ， 从 而 加 强 对 环境 的 掌控 。 

Steve Mann Ё 20 世纪 80 年 代 就 开始 尝试 制作 类 似 于 Google Glass 这 样 可 以 架 在 自己 的 鼻梁 上 ， 
以 第 一 人 称 的 角度 来 记录 周遭 事物 的 眼镜 。Mann 最 初 设计 的 设备 是 戴 在 头盔 上 的 ， 而 经 过 多 年 的 实 
验 和 反复 改进 ， 他 的 头 戴 式 智能 眼镜 变 得 越 来 越 轻巧 。 后 来 Mann 成 功 开发 出 令 智能 眼镜 小 型 化 ， 并 
与 电脑 和 网 络 相 连 的 技术 EyeTab， 这 上 比 Google 眼镜 要 早 13 fF. 

以 Google 眼镜 为 代表 的 这 种 穿戴 设备 ， 和 智能 手机 最 大 的 不 同 是 把 用 户 的 眼睛 和 手 从 设备 上 解放 
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出 来 了 ， 所 以 不 需要 从 兜 里 掏 出 一 个 东西 ， 也 不 需要 低下 头 去 看 它 ， 它 永远 在 你 前 面 。 所 以 我 们 有 理 
由 相信 ， 可 穿戴 计算 设备 〈 不 一 定 是 Google 眼镜 ) 一 定 可 以 给 人 们 带 来 更 大 的 自由 ， 并 且 在 将 来 一 定 
会 成 为 潮流 趋势 。 


2. 发 展现 状 介绍 


可 穿戴 计算 设备 将 成 为 继 智能 手机 、 平 板 电脑 之 后 的 又 一 个 潮流 。 当 前 可 穿戴 技术 正 处 于 一 种 过 
渡 时 期 ， 一 些 看 似 疯狂 的 想法 逐渐 在 摸索 中 变 得 更 加 成 熟 。 在 CES 2014 电子 消费 展 上 ， 我 们 已 经 看 到 
类 似 Pebble Steel 这 样 拥有 更 精致 设计 的 智能 手表 , 还 有 很 多 其 他 运动 腕 带 、 智 能 眼镜 等 产品 参与 展 出 ， 
下 面 一 起 来 回顾 一 下 这 些 出 色 的 可 穿戴 设备 。 

(1) Google Project Glass 

谷歌 眼镜 (Google Project Glass) 是 由 谷歌 公司 于 2012 年 4 月 发 布 的 一 款 “ 拓 展现 实 ” 眼 镜 ， 如 
图 1-12 所 示 。 谷 歌 眼 镜 具 有 和 智能 手机 一 样 的 功能 ， 可 以 通过 声音 控制 拍照 、 视 频 通话 和 辨 明 方向 以 
及 上 网 冲浪 、 处 理 文字 信息 和 电子 邮件 等 。 

2013 年 4 Н 10 日， 美国 科技 博客 Gizmodo 发 布 了 一 张 图 片 ， 揭 示 了 谷歌 智能 眼镜 的 工作 原理 。 
谷歌 眼镜 承载 着 可 穿戴 设备 的 开端 ， 极 具 想 象 空间 并 且 前 途 不 可 限量 。 但 现在 看 来 ， 其 暂时 只 是 一 个 
手机 伴侣 ， 基 础 通信 、 文 字 输 入 依赖 手机 。 

2013 年 11 月 12 日 ,谷歌 发 布 了 谷歌 眼镜 的 一 系列 新 功能 ， 包 括 搜 索 歌 曲 、 扫 描 已 保存 播放 列表 ， 
以 及 收听 高 保 真 音乐 等 。 美 国 东部 时 间 2014 年 4 月 15 日 时 上 9 点 ，Google Glass 正式 开放 网 上 订购 。 

(2) 苹果 智能 手表 

苹果 智能 手表 ,是 苹果 秘密 研发 的 产品 。 苹 果 手 表 可 能 将 采用 1.5 至 2 英寸 显示 屏 ， 并 将 采用 指纹 
识别 技术 。 苹 果 成 立 了 一 支 100 人 左右 的 开发 团队 ， 专 门 开发 这 款 设备 。2013 年 5 月 ， 凯 基 证 券 分 析 
师 郭 明 池 (Ming-Chi Kuo) 在 一 份 报告 中 指出 ， 苹 果 手 表 的 零 部 件 尚未 成 熟 ， 苹 果 手 表 最 早 2014 年 下 
半年 投产 。 而 苹果 CEO 带 姆 。 库 克 (Tim Cook) 曾 表示 ， 苹 果 期 待 2013 年 秋季 和 整个 2014 年 将 推出 
令 人 兴奋 的 新 产品 。 苹 果 手 表 的 预期 效果 如 图 1-13 所 示 。 


1-12 谷歌 眼镜 图 1-13 苹果 手表 


(3) MetaWatch 

MetaWatch 是 一 款 智能 手表 ， 其 设计 师 此 前 设计 了 奢侈 品 手机 Vertu， 所 以 非常 擅长 将 时 尚 元 素 与 
电子 产品 有 机 结合 ， 如 图 1-14 所 示 。 

由 此 可 以 看 到 ，MetaWatch 的 金属 表盘 充满 质感 ， 皮 革 腕 带 也 显得 十 分 高 级 ， 无 论 是 搭配 西装 还 
是 T 恤 ， 都 十 分 合适 。MetaWatch 支持 10~15 米 防水 ， 支 持 iOS 设备 ， 用 户 可 以 从 App Store 中 下 载 
应 用 程序 ， 实 现 更 多 信息 的 通知 功能 。 
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图 1-14 MetaWatch 


(4) Garmin Vivofit 

健身 胶带 Garmin Vivofit 是 由 知名 GPS 厂商 Garmin 推出 的 ， 此 前 推出 过 运动 手表 产品 ， 此 次 更 是 
推出 了 Vivofit 健身 腕 带 ， 全 面 进入 到 运动 监测 设备 市 场 。 这 款 运 动 腕 带 的 设计 充满 活力 ， 拥 有 多 种 配 
色 款 式 ， 不 仅 能 够 实现 全 面 的 运动 数据 监测 ， 还 支持 心率 监测 ， 与 手机 端的 应 用 搭配 ， 可 实现 出 色 的 
健身 运动 功能 ， 如 图 1-15 所 示 。 

(5) 英特尔 智能 手表 及 手镯 

芯片 巨头 英特尔 在 CES 2014 上 也 宣布 进入 可 穿戴 设备 领域 ， 将 陆续 推出 智能 手表 、 手 镯 等 产品 。 
有 意思 的 是 ， 英 特 尔 的 智能 手镯 将 与 时 尚 百货 Bameys 合作 推出 ， 或 许 能 够 让 可 穿戴 设备 在 时 尚 领域 
更 进一步 ， 如 图 1-16 所 示 。 


图 1-15 Garmin Vivofit 健身 腕 带 图 1-16 英特尔 智能 手表 及 手 锣 


1.3.3 可 穿戴 设备 的 发 展 前 景 分 析 


可 穿戴 设备 是 延续 性 地 穿戴 在 人 体 上 ， 有 具备 先进 的 电路 系统 、 无 线 联网 及 独立 处 理 能 力 的 终端 设 
备 ， 其 具备 最 重要 的 两 个 特点 是 可 长 期 穿戴 和 智能 化 。 在 智能 手机 和 平板 进入 停滞 期 后 ， 以 智能 眼镜 、 
手表 等 为 代表 的 智能 可 穿戴 设备 成 为 谷歌 、 苹 果 等 巨头 竞争 的 下 一 个 主 战场 。 著 名 科技 媒体 Android 
Authority 的 扎 稿 人 奈 特 。 斯 是 纳 〈Nate Swanner) 曾经 撰文 对 2014 年 进行 了 展望 ， 他 总 结 道 : 穿戴 设 
备 将 会 蓬勃 发 展 。 消 费 者 有 望 买 到 谷歌 眼镜 ， 而 且 市 场 上 会 出 现 很 多 智能 手表 。 如 果 你 有 意 购买 一 款 
这 样 的 设备 ， 请 务必 保持 谨慎 乐观 的 心态 。 毕 竟 ， 在 这 类 产品 爆炸 式 发 展 初期 买 下 的 设备 ， 有 可 能 在 
未 来 几 年 里 登 上 “有 史 以 来 最 糟糕 产品 ”的 榜 单 。 

(1) 智能 手机 推动 力 

智能 手机 是 可 穿戴 设备 爆发 的 核心 驱动 力 之 一 , 智能 手机 现在 已 经 不 光 是 拿 来 讲 电话 或 者 是 上 网 ， 
其 内 建 的 处 理 器 与 操作 系统 具有 强大 的 运算 能 力 ， 使 它 成 为 远程 的 计算 机 引擎 ， 而 同时 智能 手机 具有 
广泛 的 用 户 基础 ， 预 计 未 来 ， 手 机 可 能 作为 智能 控制 中 心 和 计算 系统 ， 使 可 穿戴 设备 、 平 板 、 笔 记 本 、 
电视 等 所 有 终端 保持 互联 ， 而 每 个 人 的 身体 及 可 穿戴 设备 将 变 成 微 网 络 ， 身 上 佩戴 各 式 与 智能 手机 连 
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接 的 装备 ， 提 供 各 类 功能 并 与 智能 手机 、 云 端 进行 数据 计算 和 交互 。 根 据 权 威 统计 数据 证 明 ， 中 国 移 
动 互 联网 用 户 已 超过 桌面 互联 网 用 户 。 

(2) 跨国 公司 推动 力 

随 着 智能 手机 渗透 率 快速 提升 ， 便 携 性 要 求 出 现 、 硬 件 配备 提升 、 传 感 器 及 电池 改善 ， 可 穿戴 设 
备 的 便携 、 云 端 互联 等 性 能 优势 将 越 来 越 明显 ， 预 计 可 穿戴 设备 将 是 继 智 能 手机 之 后 下 一 个 爆发 性 增 
长 点 。 尤其 是 苹果 、 Aik Mik WEWN Facebook 五 大 平台 及 相应 开发 者 都 进入 可 穿戴 设备 领域 时 ， 
后 台数 据 及 前 端 检测 传输 更 加 完善 时 ， 可 穿戴 设备 将 会 变 成 主流 。 按 照 ShareThis 2013 年 6 月 最 新 数 
据 ， 消 费 者 在 移动 设备 上 点 击 和 分 享 内 容 的 行为 是 桌面 电脑 的 2 倍 ， 随 着 社交 网 络 越发 重要 ， 可 供 分 
享 的 数据 暴 增 。 以 社交 分 享 平 台中 份额 最 高 的 Facebook 和 Google 来 研究 ， 按 照 Searchmetrics 数据 ， 
目前 Facebook 的 分 享 量 以 每 个 月 10% 的 速度 增长 ，Google 分 享 量 目 前 以 每 月 19% 的 速度 增长 ， 截 至 
2013 年 4 Н, Facebook 和 Google 的 数据 分 享 量 相 比 2012 年 初 增长 分 别 是 202% 及 788%, 数据 分 享 爆 
发 时 代 到 来 。 即 时 的 数据 分 享 和 社交 网 络 的 需求 将 导致 用 户 对 各 类 移动 终端 需求 不 断 提 升 ， 可 穿戴 设 
备 在 数据 分 享 和 社交 领域 具备 放量 基础 。 

(3) 用 户 推动 力 

用 户 对 健身 、 医 疗 及 健康 监测 等 需求 也 在 持续 抬升 ， 可 穿戴 式 设备 在 医疗 和 健康 领域 可 加 载 的 功 
能 包括 脉搏 血 氧 仪 、 葡 萄 糖 监测 、 心 电 图 (ECG)、 助 听 器 、 药 物 输送 等 。 未 来 可 穿戴 设备 作为 新 一 代 
智能 终端 ， 将 成 为 新 的 移动 平台 市 场 及 生态 圈 ， 硬 件 终端 不 仅 是 营 收 增长 点 ， 也 将 成 为 粘 住 客户 的 产 
品 形态 ， 进 而 围绕 消费 者 形成 可 穿戴 设备 、 手 机 、 平 板 、 笔 记 本 、 电 视 、 汽 车 等 终端 互联 互通 的 一 体 
化 智能 方案 ， 因 此 原 软 硬 件 、 互 联网 等 各 类 厂商 均 参 与 到 推出 硬件 终端 产品 的 环节 中 来 。 

在 可 穿戴 设备 领域 应 用 中 ， 目 前 较 受 欢迎 的 应 用 是 娱乐 和 社交 ， 而 较 快 进入 商用 的 功能 是 健身 、 
医疗 及 健康 监测 。 娱 乐 和 社交 领域 的 典型 产品 包括 Google/ 百 度 智 能 眼镜 、 索 尼 /三 星 / 果 壳 智能 手表 等 ， 
医疗 领域 可 穿戴 式 设备 主要 包括 脉搏 血 氧 仪 、 葡 萄 糖 监测 、 心 电 图 (ECG)、 助 听 器 、 药 物 输送 等 类 型 
产品 ， 目 前 主要 功能 进行 一 体 化 整合 成 为 趋势 ， 如 三 星 智能 手表 同时 也 具备 健康 监测 功能 。 

据 数据 显示 ，2012 年 中 国 可 穿戴 便携 移动 医疗 设备 市 场 销售 规模 达到 4.2 亿 元 ， 预 计 到 2015 年 这 
一 市 场 规模 将 超过 10 亿 元 ， 到 2017 年 中 国 可 穿戴 便携 移动 医疗 设备 市 场 销售 规模 将 接近 50 亿 元 ， 市 
场 年 复合 增长 达到 60%。 

HIS 预计 全 球 范围 内 与 健康 相关 的 可 穿戴 设备 App 应 用 装机 量 (或 下 载 量 ) 会 从 2012 年 的 1.56 
亿 上 升 至 2017 年 的 2.48 亿 ， 随 着 开发 者 加 入 及 生态 环境 改善 ， 可 穿戴 设备 将 放量 增长 。 

第 三 方 机 构 Endpoint Technologies Associates 预计 , 如果 未 来 5 年 可 穿戴 设备 市 场 占 比 达 4000 万 个 ， 
便 可 能 为 开发 商 带 来 4 亿美 元 商机 ， 而 程序 内 广告 (in-APP advertising) 可 能 大 幅 提升 营业 收入 。 


1.3.4 Android 对 穿戴 设备 的 支持 一 一 Android Wear 


Bluetooth Smart 低 耗 能 技术 的 推出 为 穿戴 设备 的 开发 创造 了 良好 的 条 件 ,苹果 是 从 iOS SCiPhone 4S 
以 及 以 上 版 本 的 手机 ) 开始 支持 Bluetooth Smart， 而 Google 直到 Android 4.3 才 开 始 支 持 。Google 在 
Android 4.3 中 添加 了 Bluetooth Smart， 在 操作 系统 层面 建立 一 个 统一 标准 。 也 就 是 说 ， 从 Android 43 
开始 ， 将 完全 支持 新 蓝牙 传输 技术 ， 这 样 就 为 可 穿戴 设备 开发 铺 平 了 道路 。 而 在 Android 4.4 中 ， 新 增 
加 了 地 磁 旋 转 矢 量 、 脚 步 探测 器 和 计 步 器 3 个 传感器 类 别 ， 这 些 功 能 很 可 能 是 面向 谣传 的 谷歌 Android 
智能 手表 、 谷 歌 眼 镜 以 及 非 谷歌 出 厂 的 设备 。 随 着 更 多 的 厂商 在 产品 中 加 入 运动 传感器 ， 追 踪 人 们 运 
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动 的 Android 手机 应 用 也 将 从 该 新 功能 中 获 益 。 

北京 时 间 2014 年 3 月 19 日 早 间 消 息 ,谷歌 在 官方 博客 中 公布 了 可 穿戴 设备 操作 系统 Android Wear 
的 细节 。Android Wear 是 Android 的 一 个 修改 版 ， 基 于 Google Now 语音 识别 技术 ， 针 对 可 穿戴 计算 设 
备 设计 , 最 初 将 被 用 在 智能 手表 中 。 谷歌 同时 表示 , LG. 华硕 、 НТС. 摩托 罗拉 移动 和 三 星 将 是 Android 
Wear 的 硬件 合作 伙伴 ， 而 博通 、Imagination、 英 特 尔 、 联 发 科 和 高 通 将 是 芯片 合作 伙伴 。LG 和 谷歌 将 
在 谷歌 VO 开发 者 大 会 上 发 布 智能 手表 ， 而 LG 将 是 推出 谷歌 智能 手表 的 首 家 合作 伙伴 。 

Android Wear 与 谷歌 眼镜 类 似 , 将 基于 Google Now 和 语音 命令 。 通 过 OK Google 的 语音 指令 , 用 
户 可 以 提问 或 发 送 文字 消息 。 谷 歌 表示 ，Android Wear 的 设计 是 为 了 提供 相关 性 更 好 的 信息 ， 以 及 来 
自 社交 媒体 应 用 的 通知 、 消 息 应 用 的 提示 ， 以 及 购物 、 新 闻 和 拍照 应 用 的 通知 等 。 这 一 修改 版 Android 
系统 将 专注 于 健康 和 运动 追踪 功能 。FitBit Force 和 耐克 FuelBand 等 产品 推动 了 这 类 功能 的 发 展 。 谷歌 
还 希望 ，Android Wear 将 成 为 联系 用 户 与 其 他 设备 ， 包 括 电 视 机 和 计算 机 的 纽带 。 业 内 人 士 希望 ， 谷 
歌 的 进入 将 有 助 于 提升 智能 手表 的 设计 美学 。 尽 管 可 穿戴 计算 设备 目前 非常 热门 ， 但 相关 产品 的 销售 
情况 并 不 火爆 。 三 星 第 一 代 Galaxy Gear 和 索尼 SmartWatch 仍 是 小 众 产品 ， 这 两 款 产品 的 尺寸 过 大 且 
不 时 尚 。 对 可 穿戴 计算 设备 的 其 他 不 满 还 包括 电池 续航 时 间 过 短 ， 以 及 缺少 某 些 实用 功能 等 。 
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Android 作为 一 项 新 兴 技 术 ， 在 进行 开发 前 首先 要 拱 建 一 个 对 应 的 开发 环境 。Android 开发 包括 底 
层 开 发 和 应 用 开发 ， 底 层 开发 大 多 数 是 指 和 硬件 相关 的 开发 ， 并 且 是 基于 Linux 环境 ， 例 如 开发 驱动 
程序 。 因 为 本 书 讲解 的 外 设 项 目 开发 涉及 底层 和 应 用 层 的 知识 ， 所 以 要 求 读者 熟练 运用 底层 开发 环境 
和 应 用 层 开 发 环境 。 在 本 章 的 内 容 中 ， 首 先 将 详细 讲解 搭建 Android 底层 开发 环境 的 知识 ， 详 细 介绍 
获取 并 编译 Android 源码 的 具体 方法 和 实现 流程 。 


2.1 Æ Linux 系统 中 获取 Android 源码 


ШМ 知识 点 讲解 光盘 :视频 \ 知 识 点 第 2 章 \ 在 Linux 系统 中 获取 Android 源码 .avi 

北京 时 间 2014 年 11 月 5 日， 谷歌 在 http://android.google.source.com/ 上 正式 发 布 了 Android 5.0 的 
源码 ， 如 图 2-1 所 示 。 

根据 图 2-1 所 示 的 分 支 名 可 以 下 载 Android 5.0 的 源码 。 在 Linux 系统 中 ,通常 使 用 Ubuntu 来 下 载 
和 编译 Android 源码 。 由 于 Android 的 源码 内 容 很 多 ，Google 采用 了 git 的 版 本 控制 工具 ， 并 对 不 同 的 
模块 设置 不 同 的 git 服务 器 , 我 们 可 以 用 repo 自动 化 脚本 来 下 载 Android 源码 ， 下 面 介绍 如 何 一 步 一 步 
地 获取 Android 源码 的 过 程 。 


(1) 下 载 repo 
在 用 户 目录 下 ， 创 建 bin 文件 夹 ， 用 于 存放 repo， 并 把 该 路 径 设置 到 环境 变量 中 ， 命 令 如 下 : 
$ mkdir ~/bin 


$ PATH=~/bin:$PATH 
下 载 repo 的 脚本 ， 用 于 执行 repo， 命 令 如 下 : 
$ curl https://dl-ssl.google.com/dl/googlesource/git-repo/repo > ~/bin/repo 
设置 可 执行 权限 ， 命 令 如 下 : 
$ chmod a+x ~/bin/repo 
(2) 初始 化 一 个 repo 的 客户 端 
在 用 户 目录 下 ， 创 建 一 个 空 目录 ， 用 于 存放 Android 源码 ， 命 令 如 下 : 
$ mkdir AndroidCode 
$ cd AndroidCode 
进入 到 AndroidCode 目录 ， 并 运行 repo 下 载 源码 ， 下 载 主线 分 支 的 代码 ， 主 线 分 支 包 括 最 新 修改 
的 bug， 以 及 并 未 正式 发 出 版 本 的 最 新 源码 ， 命 令 如 下 : 
$ repo init -u https://android.googlesource.com/platform/manifest 
下 载 其 他 分 支 ， 正 式 发 布 的 版 本 ， 可 以 通过 添加 -b 参数 来 下 载 ， 命 令 如 下 : 
$ repo init -u https://android.googlesource.com/platform/manifest -b 
android-5.0_r1 


在 下 载 过 程 中 会 需要 填写 Name 和 Email， 填 写 完毕 之 后 ， 选 择 Y 进行 确认 ， 最 后 提示 repo 初始 
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化 完成 ， 这 时 可 以 开始 同步 Android 源码 了 ， 同 步 过 程 很 漫长 ， 需 要 耐心 地 等 待 ， 执 行 下 面 命令 开始 
同步 代码 : 

$ repo sync 

经 过 上 述 步骤 后 ， 便 开始 下 载 并 同步 Android W 


Google 


android / platform/manifest 


Branches Tags 


ne. 
‚ done. 
done.ng 1 


"и 
160% (9 
: 100% (45 

files 


图 2-1 Android 5.0 的 源码 分 支 E22 下载 同步 


22 J Windows 平台 获取 Android 源码 


ШИ 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 2 EVE Windows 平台 获取 Android 源码 .avi 

在 Windows 平台 获取 Android 源码 的 原理 和 Linux 相同 ， 但 是 需要 预先 在 Windows 平台 上 面 搭建 
一 个 Linux 模拟 环境 ， 笔 者 使 用 的 是 cygwin 工具 。cygwin 的 作用 是 构建 一 套 在 Windows 上 的 Linux 
模拟 环境 ， 下 载 cygwin 工具 的 地 址 如 下 : 

http://cygwin.com/install.html 

下 载 成 功 后 会 得 到 一 个 名 为 setup.exe 的 可 执行 文件 ,通过 此 文件 可 以 更 新 和 下 载 最 新 的 工具 版 本 ， 
具体 流程 如 下 。 

CD 启动 cygwin， 如 图 2-3 所 示 。 
| сиса воет. с ini xi 

Cygwin Net Release Setup Program 


This setup program is used for the intial installation of the 
Cygwin environment as мей as all subsequent updates. Make 
sure to remember where you saved t 


The pages that folow wil guide you through the instalation. 

Please note that Cygwin consists of a large number of 
packages spanning a wide variety of purposes. We only 

D sala base set of packages by defaut. You can aways run 

this program at any time in the future to add, remove, or 


upgrade packages as necessary 
Setup.exe version 2.819 (32 bit) 
Copyright 20002013 
hep ¿Aw сун) com 
T 


图 2-3 启动 cygwin 
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(2) 单 击 “ 下 一 步 ” 按 钮 ， 在 进入 的 界面 中 选中 第 一 个 单 选 按钮 ， 表 示 从 网 络 下 载 安装 ， 如 图 2-4 


所 示 。 
(3) 单 击 “ 下 一 步 ”按钮 ， 在 进入 的 界面 中 选择 安装 根 目录 ， 如 图 2-5 所 示 。 
209 ш 
Choose A Download Source ‘Select Root Install Directory 
Choose whether to instal or download from the intemet, or nstall from fles in E Select the directory where you want to install Cygwin. Also choose a few C 
local directory. instalation parameters. 
Root Directory 
[EF — Leme | 
© Install from intemet 
downloaded files will be keot for future re-use) rial For 


© Download Without nataling 


C Instal from Local Directory 


(© А Users (RECOMENDED) 
Cygwin wil be avaiable to al users ofthe system. 


C dus Me 
Cygwin wd яй be avaliable to al users, but Desktop Icons, Cygwin Menu Entries, and 
Instalerinfomation are only avaiable to the curent user. Only select this f 
youlack Administrator privieges or f you have specfic needs, 


_аж | 
24 选择 从 网 络 下 载 安 装 


《上 - 步 @) 取消 


25 选择 安装 根 目录 


(4) 单 击 “ 下 一 步 ” 按 钮 ， 选 择 临 时 文件 目录 ， 如 图 2-6 所 示 。 
(5) 单 击 “ 下 一 步 ”按钮 ， 在 进入 的 界面 中 设置 网 络 代理 。 如 果 所 在 网 络 需 要 代 
7 所 示 。 


1ш х 
Select Local Package Directory 
Select а drectory where you wart Setup to store the instalation fles t C 
downloads. The drectory wil be created ft does not ready ex. 
[ Local Package Drectoy 
wooo 上 me | 


中 进行 设置 ， 如 果 不 用 代理 ， 则 选择 直接 下 载 ， 如 图 2- 


理 ， 则 在 这 一 步 


ME 
lx 


— | 
2-6 选择 临时 文件 目录 


(6) 单 击 “ 下 一 步 ”按钮 ， 在 进入 的 界面 中 选择 
下 载 站 点 。 一 般 选 择 离 我 们 比较 近 的 站 点 ， 速 度 会 比较 
快 ， 这 里 选择 的 是 台湾 站 点 ， 如 图 2-8 所 示 。 

(7) 单 击 “ 下 一 步 ” 按 钮 ， 开 始 更 新 工具 列表 ， 
如 图 2-9 所 示 。 

(8) 单 击 “ 下 一 步 ” 按 钮 ， 在 进入 的 界面 中 选择 
需要 下 载 的 工具 包 。 在 此 我 们 需要 依次 下 载 curl, git. 
python 这 些 工 具 ， 如 图 2-10 所 示 。 

为 了 确保 能 够 安装 上 述 工具 , 一 定 要 用 鼠标 双击 变 
73 Install 形式 ， 如 图 2-11 所 示 。 


[OR 


< t-50) mA 


图 2-7 设置 网 络 代理 


Choose A Site 


AF r A 取消 


图 2-8 选择 下 载 站 点 
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(9) 单 击 “ 下 一 步 ” 按 钮 ， 进 入 漫长 的 等 待 过 程 ， 如 图 2-12 所 示 。 


С Cygwin Setup zia | 
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图 2-11 务必 设置 为 Install 形式 


如 果 下 载 安装 成 功 会 出 现 提 示 信 息 , 单 击 “ 完 成 ” 
会 模拟 出 一 个 Linux 的 工作 环境 ， 然 后 按照 Linux 平台 的 源码 下 载 方法 
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图 2-10 依次 下 载 工 具 
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图 2-12 ”下载 进度 条 


"按钮 即 完 成 安装 。 当 安装 好 cygwin 后 ,打开 cygwin， 


就 可 以 下 载 Android 源码 了 。 


建议 读者 在 下 载 Android 源码 时 ， 严 格 按照 官方 提供 的 步骤 进行 ， 地 址 是 http://source.android. 
/source/downloading.html， 这 一 点 对 初学 者 来 说 尤为 重要 。 另 外 ， 整 个 下 载 过 程 比较 漫长 ， 需 要 大 家 耐 


心 等 待 。 例 如 ， 图 2-13 是 笔者 下 载 Android 5.0 时 的 机 器 命令 截图 。 


| 


图 2-13 在 Windows 中 用 cygwin 工具 下 载 Android 源码 的 截图 
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23 编译 源码 


М 知识 点 讲解 光盘 :视频 \ 知 识 点 \ 第 2 章 \ 编 译 源码 .avi 

编译 Android 源码 的 方法 非常 简单 ， 只 需 使 用 Android 源码 根 目录 下 的 Makefile， 执 行 make 命令 
即 可 轻松 实现 。 当 然 在 编译 Android 源码 之 前 ， 首 先 要 确定 已 经 完成 同步 工作 。 进 入 Android 源码 目录 
使 用 make 命令 进行 编译 ， 使 用 此 命令 的 格式 如 下 : 

$: cd ~/Android 5.0 GX EB) “Android 5.0” 就 是 我 们 下 载 源码 的 保存 目录 ) 

$: make 


编译 Android 源码 可 以 得 到 “~/projectyandroid/cupcake/out” 目 录 ， 笔 者 的 截图 界面 如 图 2-14 所 示 。 


图 2-14 编译 过 程 的 界面 截图 
整个 编译 过 程 也 非常 漫长 ， 需 要 读者 耐心 等 待 。 


2.3.1 搭建 编译 环境 


在 编译 Android 源码 之 前 ， 需 要 先进 行 环境 搭建 工作 。 在 接 下 来 的 内 容 中 ， 以 Ubuntu 系统 为 例 讲 
解 搭建 编译 环境 以 及 编译 Android 源码 的 方法 。 具 体 流 程 如 下 。 
СТ) 安装 IDK, 编译 Android 5.0 的 源码 需要 JDK 插件 ， 可 以 下 载 jdk-6u22-linux-i586.bin 后 进行 
安装 ， 对 应 命令 如 下 : 
$ cd /usr 
$ mkdir java 
$ cd java 
$ sudo ср jdk-6u22-linux-i586.bin 所 在 目录 ./ 
$ sudo chmod 755 jdk-6u22-linux-i586.bin 
$ sudo sh jdk-6u22-linux-i586.bin 
(2) 设置 JDK 环境 变量 ,将 如 下 环境 变量 添加 到 主 文件 夹 目录 下 的 .bashrc 文件 中 , 然后 用 source 
命令 使 其 生效 ， 加 入 的 环境 变量 代码 如 下 : 


s, 
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export JAVA HOME-/usr/java/jdk1.6.0 23 
export JRE HOME-$JAVA HOME/jre 
export CLASSPATH=.:$JAVA_HOME/lib:$JRE_HOME/lib:$CLASSPATH 
export PATH=$PATH:$JAVA_HOME/bin:$JAVA_HOME/bin/tools јаг:$ЈКЕ HOME/bin 
export ANDROID JAVA HOME-$JAVA HOME 
(3) 安装 需要 的 包 ， 读 者 可 以 根据 编译 过 程 中 的 提示 进行 选择 ， 可 能 需要 的 包 的 安装 命令 如 下 : 
$ sudo apt-get install git-core bison zlib1g-dev flex libx12-dev gperf sudo aptitude install git-core gnupg flex 
bison gperf libsdl-dev libesd0-dev libwxgtk2.6-dev build-essential zip curl libncurses5-dev zlib1g-dev 


2.82 ”开始 编译 


当 所 依赖 的 包 安 装 完成 之 后 ， 就 可 以 开始 编译 Android 源码 了 ， 具 体 步骤 如 下 。 
(1) 首先 进行 编译 初始 化 工作 ， 在 终端 中 执行 下 面 的 命令 : 
source build/envsetup.sh 
或 : 
. build/envsetup.sh 
执行 后 将 会 输出 : 
source build/envsetup.sh 
including device/asus/grouper/vendorsetup.sh 
including device/asus/tilapia/vendorsetup.sh 
including device/generic/armv7-a-neon/vendorsetup.sh 
including device/generic/armv7-a/vendorsetup.sh 
including device/generic/mips/vendorsetup.sh 
including device/generic/x86/vendorsetup.sh 
including device/samsung/maguro/vendorsetup.sh 
including device/samsung/manta/vendorsetup.sh 
including device/samsung/toroplus/vendorsetup.sh 
including device/samsung/toro/vendorsetup.sh 
including device/ti/panda/vendorsetup.sh 
including sdk/bash_completion/adb.bash 
(2) 然后 选择 编译 目标 ， 命 令 如 下 : 
lunch full-eng 
执行 后 会 输出 如 下 的 提示 信息 。 


PLATFORM_VERSION_CODENAME=REL 
PLATFORM_VERSION=5.0 
TARGET_PRODUCT=full 
TARGET_BUILD_VARIANT=eng 
TARGET_BUILD_TYPE=release 
TARGET BUILD APPS= 

TARGET ARCH-arm 

TARGET ARCH VARIANT-armv7-a 
HOST ARCH-x86 

HOST OS=linux 

HOST OS EXTRA-Linux-2.6.32-45-generic-x86 64-with-Ubuntu-10.04-lucid 
HOST BUILD TYPE-release 

BUILD ID-JOP40C 

OUT DIR-out 
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(3) 接 下 来 开始 编译 代码 ， 在 终端 中 执行 下 面 的 命令 : 

make -j4 

其 中 -4 表示 用 4 个 线程 进行 编译 。 整 个 编译 进度 根据 不 同 机 器 的 配置 而 需要 不 同 的 时 间 。 例 如 笔者 
电脑 为 intel 15-2300 四 核 2.8，4G 内 存 ， 经 过 近 4 小 时 才 编 译 完 成 。 当 出 现下 面 的 信息 时 表示 编译 完成 。 

target Java: ContactsTests (out/target/common/obj/APPS/Contacts Tests_intermediates/classes) 

target Dex: Contacts 

Done! 

Install: out/target/product/generic/system/app/Browser.odex 

Install: out/target/product/generic/system/app/Browser.apk 

Note: Some input files use or override a deprecated API. 

Note: Recompile with -Xlint:deprecation for details. 

Copying: out/target/common/obj/APPS/Contacts_intermediates/noproguard.classes.dex 

target Package: Contacts (out/target/product/generic/obj/APPS/Contacts_intermediates/package.apk) 

'out/target/common/obj/APPS/Contacts intermediates/classes.dex' as 'classes.dex'... 

Processing target/product/generic/obj/APPS/Contacts intermediates/package.apk 

Done! 

Install: out/target/product/generic/system/app/Contacts.odex 

Install: out/target/product/generic/system/app/Contacts.apk 

build/tools/generate-notice-files.py — out/target/product/generic/obj/NOTICE.txt  out/target/product/generic/obj/ 

NOTICE.html "Notices for files contained in the filesystem images in this directory" out/target/product/generic/ 

obj/NOTICE FILES/src 

Combining NOTICE files into HTML 

Combining NOTICE files into text 

Installed file list: out/target/product/generic/installed-files.txt 

Target system fs image: out/target/product/generic/obj/PACKAGING/systemimage intermediates/system.img 

Running: mkyaffs2image -f out/target/product/generic/system out/target/product/generic/obj/PACKAGING/syste- 

mimage intermediates/system.img 

Install system fs image: out/target/product/generic/system.img 

DroidDoc took 5331 sec. to write docs to out/target/common/docs/doc-comment-check 


2.3.3 ”在 模拟 器 中 运行 


在 模拟 器 中 运行 的 步骤 就 比较 简单 了 ， 只 需 在 终端 中 执行 下 面 的 命令 即 可 。 
emulator 


运行 成 功 后 的 效果 如 图 2-15 所 示 。 


Check your E-mail for Download Link 


< Easy-t 


< Optimized, small-& 
¥ JTAG probe support 


2-15 提示 在 邮件 中 得 到 下 载 地 址 
23.4 ”常见 的 错误 分 析 


虽然 编译 方法 非常 简 


e 


Im. 


和 ， 但 是 作为 初学 者 来 说 很 容易 出 错 ， 在 下 面 列 出 了 其 中 常见 的 编译 错误 类 型 。 
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(1) 缺少 必要 的 软件 

BEA Android 目录 下 ， 使 用 make 命令 编译 ， 可 能 会 发 现 出 现 如 下 错误 提示 。 

host С: libneo_cgi <= external/clearsilver/cgi/cgi.c 

external/clearsilver/cgi/cgi.c:22:18: error: zlib.h: No such file or directory 

上 述 错误 是 因为 缺少 zliblg-dev, 需要 使 用 apt-get 命令 从 软件 仓库 中 安装 zliblg-dev, 具体 命令 如 下 : 

sudo apt-get install zlib1g-dev 

同 理 需 要 安装 下 面 的 软件 ， 否 则 也 会 出 现 上 述 类 似 的 错误 。 

sudo apt-get install flex 

sudo apt-get install bison 

sudo apt-get install gperf 

sudo apt-get install libsdl-dev 

sudo apt-get install libesd0-dev 

sudo apt-get install libncurses5-dev 

sudo apt-get install libx12-dev 

(2) 没有 安装 Java 环境 JDK 

当 安 装 所 有 上 述 软件 后 ， 运 行 make 命令 再 次 编译 Android 源码 。 如 果 在 之 前 忘记 安装 Java 环境 
JDK， 则 此 时 会 出 现 很 多 Java 文件 无 法 编译 的 错误 ， 如 果 打开 Android 的 源码 ， 可 以 看 到 在 如 下 目录 
中 下 发 现 有 很 多 Java 源 文件 。 

android/dalvik/libcore/dom/src/test/java/org/w3c/domts 

这 充分 说 明 在 编译 Android 之 前 必须 先 安装 Java 环境 JDK， 安 装 流程 如 下 。 

口 从 Oracle 官 方 网 站 下 载 jdk-6u16-linux-i586.bin 文 件 ， 然 后 安装 。 

在 Ubuntu 8.04 中 ,“/etc/profile” 文 件 是 全 局 的 环境 变量 配置 文件 ， 它 适用 于 所 有 的 shell。 在 登录 
Linux 系统 时 应 该 先 启动 “/etc/profile ”文件 , 然后 再 启动 用 户 目录 下 的 “~/.bash_profile”“~/.bash_ login" 
或 “~/.profile” 文 件 中 的 一 个 ， 执 行 的 顺序 和 上 面 的 排序 一 样 。 如 果 “~/.bash_profile” 文 件 存在 话 ， 
则 还 会 执行 “~/.bashre” 文 件 。 在 此 只 需要 把 IDK 的 目录 放 到 “/etc/profile” 目 录 下 即 可 。 

JAVA HOME-/usr/local/src/jdk1.6.0 16 

PATH=$PATH:$JAVA_HOME/bin:/ust/local/src/android-sdk-linux_x86-1.1_r1/tools:~/bin 

О 重新 启动 机 器 ， 输 入 java -version 命 令 ， 输 出 下 面 的 信息 则 表示 配置 成 功 。 

ava version "1.6.0_16" 

Java(TM) SE Runtime Environment (build 1.6.0 16-601) 

Java HotSpot(TM) Client VM (build 13.2-b01, mixed mode, sharing) 

当成 功 编译 Android 源码 后 ， 在 终端 会 输出 如 下 提示 。 

Target system fs image: out/target/product/generic/obj/PACKAGING/systemimage_unopt_intermediates/system.img 

Install system fs image: out/target/product/generic/system.img 

Target ram disk: out/target/product/generic/ramdisk.img 

Target userdata fs image: out/target/product/generic/userdata.img 

Installed file list: out/target/product/generic/installed-files.txt 

root@dfsun2009-desktop:/bin/android# 
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演示 两 种 编译 Android 程序 的 方法 


ЁШ 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 2 章 \ 演 示 两 种 编译 Android 程序 的 方法 .avi 
Android 编译 环境 本 身 比较 复杂 ， 并 且 不 像 普 通 的 编译 环境 那样 只 有 顶层 目录 下 才 有 Makefile X 


图 


М аяа 


件 , 而 其 他 的 每 个 component 都 使 用 统一 标准 的 Android.mk 文件 。 不 过 这 并 不 是 我 们 熟悉 的 Makefile, 
而 是 经 过 Android 自身 编译 系统 的 很 多 处 理 的 。 所 以 说 要 真正 理 清楚 其 中 的 联系 还 比较 复杂 ， 不 过 这 
种 方式 的 好 处 在 于 ， 编 写 一 个 新 的 Android.mk 给 Android 增加 一 个 新 的 Component 会 变 得 比较 简单 。 
为 了 使 读者 更 加 深入 地 理解 在 Linux 环境 下 编译 Android 程序 的 方法 , 在 接 下 来 的 内 容 中 , 将 分 别 演示 
两 种 编译 Android 程序 的 方法 。 


2.4.1 编译 Native С (ЖС 程序 ) 的 helloworld 模块 


编译 Java 程序 可 以 直接 采用 Eclipse 的 集成 环境 来 完成 , 实现 方法 非常 简单 , 在 这 里 就 不 再 重复 了 。 
接 下 来 将 主要 针对 C/C++ 进行 说 明 ， 通 过 一 个 例子 来 讲解 在 Android 中 增加 一 个 C 程序 的 Hello World 
的 方法 。 
(1) TES(YOUR. ANDROID)/development. 目录 下 创建 一 个 名 为 hello 的 目录 ， 并 用 “$(YOUR_ 
ANDROID)” 指 向 Android 源 代码 所 在 的 目录 。 
-#mkdir $(YOUR_ANDROID)/development/hello 
(2) 在 目录 $(YOUR_ANDROID)/developmenthello/ 下 编写 一 个 名 为 hello.c 的 C 语言 文件 ， 文 件 
hello.c 的 实现 代码 如 下 所 示 。 
#include <stdio.h> 
int main() 


printf("Hello WorldNn");// 输 出 Hello World 
return 0; 
} 

(3) 在 目录 “$(YOUR_ANDROID)/development/hello/” 下 编写 Android.mk 文件 。 这 是 Android 
Makefile 的 标准 命名 ， 不 能 更 改 。 文 件 Android.mk 的 格式 和 内 容 可 以 参考 其 他 已 有 的 Android.mk 文件 
的 写法 ， 针 对 helloworld 程序 的 Android.mk 文件 内 容 如 下 所 示 。 

LOCAL_PATH:= $(call my-dir) 
include $(CLEAR_VARS) 
LOCAL_SRC_FILES:=\ 

hello.c 
LOCAL_MODULE := helloworld 
include $(BUILD_EXECUTABLE) 


上 述 各 个 内 容 的 具体 说 明 如 下 。 

O LOCAL SRC FILES: 用 来 指定 源 文件 用 。 

O LOCAL MODULE: 指定 要 编译 的 模块 的 名 字 ， 在 下 一 步骤 编译 时 将 会 用 到 。 

O include S(BUILD EXECUTABLE): 表示 要 编译 成 一 个 可 执行 文件 ， 如 果 想 编译 成 动态 库 则 可 用 
BUILD SHARED LIBRARY， 这 些 具体 用 法 可 以 在 S(YOUR_ANDROID)/build/core/config.mk 
中 查 到 。 

(4) 回 到 Android 源 代码 顶层 目录 进行 编译 。 
# cd $(YOUR_ANDROID) && make helloworld 
在 此 需要 注意 ，make helloworld 中 的 目标 名 helloworld 就 是 上 面 Android.mk 文件 中 由 


LOCAL MODULE 指定 的 模块 名 ， 最 终 的 编译 结果 如 下 所 示 。 
target thumb C: helloworld <= development/hello/hello.c 
target Executable: helloworld (out/target/product/generic/ob/EXECUTABLES/helloworld_intermediates/LINKED/ 


e 
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helloworld) 
target Non-prelinked: helloworld (out/target/product/generic/symbols/system/bin/helloworld) 
target Strip: helloworld (out/target/product/generic/obj/EXECUTABLES/helloworld_intermediates/helloworld) 
Install: out/target/product/generic/system/bin/helloworld 

(5) 如 果 和 上 述 编译 结果 相同 ， 则 编译 后 的 可 执行 文件 存放 在 如 下 目录 人: 
out/target/product/generic/system/bin/helloworld 
这 样 通过 adb push 将 它 传送 到 模拟 器 上 ， 再 通过 adb shell 登录 到 模拟 器 终端 后 就 可 以 执行 了 。 


2.4.2 手工 编译 C 模块 


前 面 讲 解 了 通过 标准 的 Android.mk 文件 来 编译 C 模块 的 具体 流程 ， 其 实 也 可 以 直接 运用 ecc 命令 
行 来 编译 C 程序 ， 这 样 可 以 更 好 地 了 解 Android 编译 环境 的 细节 。 具 体 流程 如 下 。 
(1) 在 Android 编译 环境 中 ， 提 供 了 showcommands 选项 来 显示 编译 命令 行 ， 我 们 可 以 通过 打 
这 个 选项 来 查看 一 些 编译 时 的 细节 。 
(2) 在 具体 操作 之 前 需要 使 用 如 下 命令 把 前 面 中 的 helloworld 模块 清除 。 
# make clean-helloworld 
上 面 的 “make clean-$(LOCAL MODULE)" (i4 J& Android 编译 环境 提供 的 make clean 的 方式 。 
(3) 使 用 showcommands 选项 重新 编译 helloworld， 具 体 命令 如 下 所 示 。 
# make helloworld showcommands 
build/core/product_config.mk:229: WARNING: adding test ОТА key 
target thumb C: helloworld <= development/hello/hello.c 
prebuilt/linux-x86/toolchain/arm-eabi-5.0.1/bin/arm-eabi-gcc -| system/core/include -| hardware/libhardware/ 
include -I hardware/ril/include -I dalvik/libnativehelper/include -I frameworks/base/include -lexternal/ 
skia/include -| out/target/product/generic/obj/include -I bionic/libc/arch-arm/include -I bionic/libc/include 
-| bionic/libstdc++/include -I bionic/libc/kernel/common -l bionic/libc/Kernel/arch-arm -Ibionic/libm/ 
include — -Ibionic/libm/include/arch/arm -lbionic/libthread db/include -I development/hello -I 
out/target/product/generic/obj/EXECUTABLES/helloworld intermediates -c -fno-exceptions -Wno-multichar 
-march-armv5te -mtune=xscale -msoft-float -fpic -mthumb-interwork -ffunction-sections -funwind-tables 
-fstack-protector-D ARM ARCH 5. -D ARM ARCH 5T -D ARM ARCH 5E -D ARM ARCH 5TE . 
-include system/core/include/arch/linux-arm/AndroidConfig.h -DANDROID -fmessage-length-0 -W -Wall 
-Wno-unused -DSK RELEASE -DNDEBUG -02 -g -Wstrict-aliasing=2 -finline-functions 
-fno-inline-functions-called-once -fgcse-after-reload -frerun-cse-after-loop -frename-registers -DNDEBUG 
-UDEBUG -mthumb -Os -fomit-frame-pointer -fno-strict-aliasing -finline-limit=64 -MD -o 
out/target/product/generic/obj/EXECUTABLES/helloworld_intermediates/hello.o development/hello/hello.c 


target Executable: helloworld (out/target/product/generic/obj/EXECUTABLES/helloworld_intermediates/LINKED/ 
helloworld) 


prebuilt/linux-x86/toolchain/arm-eabi-5.0.1/bin/arm-eabi-g++ -nostdlib -Bdynamic -WI,-T,build/core/armelf.x 
-WI,-dynamic-linker,/system/bin/linker -WI,--gc-sections -WI,-z,nocopyreloc -o out/target/product/generic/obj/ 
EXECUTABLES/helloworld_intermediates/LINKED/helloworld -Lout/target/product/generic/obj/lib -WI,-rpath-link 
=out/target/product/generic/obj/lib -Ic -lstdc++ -m out/target/product/generic/obj/lib/crtbegin dynamic.o 
out/target/product/generic/obj/EXECUTABLES/helloworld_intermediates/hello.o -WI,--no-undefined 
prebuilt/linux-x86/toolchain/arm-eabi-5.0.1/bin/../lib/gcc/arm-eabi/5.0.1/interwork/libgcc.a 
out/target/product/generic/obj/lib/crtend android.o 


target Non-prelinked: helloworld (out/target/product/generic/symbols/system/bin/helloworld) 


图 
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out/host/linux-x86/bin/acp -fpt out/target/product/generic/obj/EXECUTABLES/helloworld_intermediates/LINKED/ 
helloworld out/target/product/generic/symbols/system/bin/helloworld 


target Strip: helloworld (out/target/product/generic/obj/EXECUTABLES/helloworld_intermediates/helloworld) 


out/host/linux-x86/bin/soslim —strip -shady --quiet out/target/product/generic/symbols/system/bin/helloworld 
—outfile out/target/product/generic/obj/EXECUTABLES/helloworld intermediates/helloworld 


Install: out/target/product/generic/system/bin/helloworld 


out/host/inux-x86/bin/acp -fpt out/target/product/generic/obj/EXECUTABLES/helloworld_intermediates/helloworld 
out/target/product/generic/system/bin/helloworld 
从 上 述 命令 行 可 以 看 到 ，Android 编译 环境 所 用 的 交叉 编译 工具 链 如 下 所 示 。 
prebuilt/linux-x86/toolchain/arm-eabi-5.0.1/bin/arm-eabi-gcc 


其 中 参数 -I 和 -L 分 别 指定 了 所 用 的 C 库 头 文件 和 动态 库 文件 路 径 分 别 是 bionic/libe/include 和 


out/target/product/generic/obj/li， 其 他 还 包括 很 多 编译 选项 以 及 -D 所 定义 的 预 编译 宏 。 


(4) 此 时 就 可 以 利用 上 面 的 编译 命令 来 手工 编译 helloworld 程序 ， 首 先 手工 删除 上 次 编译 得 到 的 


helloworld 程序 。 


# rm out/target/product/generic/obj/EXECUTABLES/helloworld intermediates/hello.o 
# rm out/target/product/generic/system/bin/helloworld 
然后 再 用 gee 编译 以 生成 目标 文件 。 

# prebuilt/linux-x86/toolchain/arm-eabi-5.0.1/bin/arm-eabi-gcc -| bionic/libc/arch-arm/include -| bionic/libc/include -| 
bionic/libc/kernel/common -I bionic/libc/kernel/arch-arm -c -fno-exceptions -Wno-multichar -march-armv5te 
-mtune=xscale -msoft-float -fpic -mthumb-interwork -ffunction-sections -funwind-tables -fstack-protector-D 
ARM ARCH 5 -D ARM ARCH 5T -D ARM ARCH 5E -D ARM ARCH STE -include system/ 
core/include/arch/linux-arm/AndroidConfig.h -DANDROID -fmessage-length=0 -W -Wall -Wno-unused -DSK_ 
RELEASE -DNDEBUG -02 -g -Wstrict-aliasing=2 -finline-functions -fno-inline-functions-called-once -fgcse- 
after-reload -frerun-cse-after-loop -frename-registers -DNDEBUG -UDEBUG -mthumb -Os -fomit-frame- pointer 
-fno-strict-aliasing -finline-limit=64 -MD -o out/target/product/generic/obj/EXECUTABLES/ helloworld_ 
intermediates/hello.o development/hello/hello.c 


如 果 此 时 与 Android.mk 编译 参数 进行 比较 ， 会 发 现 上 面 主要 减少 了 不 必要 的 参数 -[。 
(5) 接 下 来 开始 生成 可 执行 文件 。 

# prebuilt/linux-x86/toolchain/arm-eabi-5.0.1/bin/arm-eabi-gcc -nostdlib -Bdynamic -WI,-T,build/core/armelf.x 
-WI,-dynamic-linker,/system/bin/linker -WI,--gc-sections -WI,-z,nocopyreloc -o out/target/product/generic/obj/ 
EXECUTABLES/helloworld_intermediates/LINKED/helloworld -Lout/target/product/generic/obj/lib 
-WI,-rpath-link=out/target/product/generic/obj/lib -ic -Im out/target/product/generic/obj/EXECUTABLES/ 
helloworld_intermediates/hello.o out/target/product/generic/obj/lib/crtbegin_dynamic. 

o -WI,—no-undefined ./prebuilt/inux-x86/toolchain/arm-eabi-5.0.1/bin/. /lib/gcc/arm-eabi/5.0.1/interwork/libgcc. 
a out/target/product/generic/obj/lib/crtend_android.o 


在 此 需要 特别 注意 的 是 参数 “-Wl,-dynamic-linker,/system/bin/linker”， 它 指定 了 Android 专用 的 动 


态 链 接 器 是 “/system/bin/linker”， 而 不 是 平常 使 用 的 1d.so。 


(6) 最 后 可 以 使 用 命令 file 和 readelf 来 查看 生成 的 可 执行 程序 。 

# file out/target/product/generic/obj/EXECUTABLES/helloworld_intermediates/LINKED/helloworld 

out/target/product/generic/obj/EXECUTABLES/helloworld_intermediates/LINKED/helloworld: ELF 32-bit LSB 
executable, ARM, version 1 (SYSV), dynamically linked (uses shared libs), not stripped 

# readelf -d out/target/product/generic/obj/EXECUTABLES/helloworld_intermediates/LINKED/helloworld 


e 
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|grep NEEDED 
0х00000001 (NEEDED) Shared library: [libc.so] 
0x00000001 (NEEDED) Shared library: [libm.so] 


这 就 是 ARM 格式 的 动态 链接 可 执行 文件 ， 在 运行 时 需要 libe.so 和 libm.so。 当 提示 not stripped 时 
表示 它 还 没 被 STRIP (和 剥离 )。 嵌 入 式 系统 中 为 节省 空间 通常 将 编译 完成 的 可 执行 文件 或 动态 库 进 行 剥 
离 ， 即 去 掉 其 中 多 余 的 符号 表 信 息 。 在 前 面 make helloworld showcommands 命令 的 最 后 我 们 也 可 以 看 
到 ，Android 编译 环境 中 使 用 了 out/host/linux-x86/bin/soslim 工具 进行 STRIP。 


2.5 编译 Android Kernel 
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编译 Android Kernel 代码 就 是 编译 Android 内 核 代码 ， 在 进行 具体 编译 工作 之 前 需要 先 了 解 在 
Android 开源 系统 中 包含 的 如 下 3 部 分 代码 。 

口 仿真 器 公共 代码 : 对 应 的 工程 名 是 kemel/common.get。 

О MSM 平 台 的 内 核 代码 :对 应 的 工程 名 是 kernel/msm.get。 

O OMAP 平 台 的 内 核 代码 ， 对 应 的 工程 名 是 kemel/omap.get。 

在 本 节 的 内 容 中 ， 将 详细 讲解 编译 上 述 Android Kernel 的 基本 知识 。 


2.5.1 获取 Goldfish 内 核 代码 


Goldfish 是 一 种 虚拟 的 ARM 处 理 器 , 通常 在 Android 的 仿真 环境 中 使 用 。 在 Linux 的 内 核 中 , Goldfish 
作为 ARM 体系 结构 的 一 种 “机 器 ”。 在 Android 的 发 展 过 程 中 ，Goldfish 内 核 的 版 本 也 从 Linux 2.6.25 
升级 到 了 Linux 3.4， 此 处 理 器 的 Linux 内 核 和 标准 的 Linux 内 核 有 以 下 3 个 方面 的 差别 。 

口 Goldfish 机 器 的 移植 。 

Q Goldfish 一 些 虚 拟 设备 的 驱动 程序 。 

口 Android 中 特有 的 驱动 程序 和 组 件 。 

Goldfish 处 理 器 有 两 个 版 本 ， 分 别 是 ARMv 5 和 ARMv 7， 在 一 般 情 况 下 ， 只 需 使 用 ARMv 5 版 本 
即 可 。 在 Android 开源 工程 的 代码 仓库 中 ， 使 用 git 工具 得 到 Goldfish 内 核 代码 的 命令 如 下 所 示 。 

$ git clone git://android.git.kernel.org/kernel/common.git 

在 其 Linux 源 代码 的 根 目 录 中 ， 配 置 和 编译 Goldfish 内 核 的 过 程 如 下 所 示 。 


$make ARCH=arm goldfish_defconfig .config 
$make ARCH=arm CROSS COMPILE-(path)/arm-none-linux-gnueabi- 


其 中 ，CROSS_COMPILE 的 path 值 用 于 指定 交叉 编译 工具 的 路 径 。 
编译 结果 如 下 所 示 。 


LD vmlinux 

SYSMAP system.map 

SYSMAP .tmp_system.map 

OBJCOPY arch/arm/boot/Image 

Kernel: arch/arm/boot/Image is ready 

AS arch/arm/boot/compressed/head.o 
GZIP arch/arm/boot/compressed/piggy.gz 


Android 外 设 开发 实战 


AS arch/arm/boot/compressed/piggy.o 

CC arch/arm/boot/compressed/misc.o 

LD arch/arm/boot/compressed/vmlinux 
OBJCONPY arch/arm/boot/zimage 
Kernel: arch/arm/boot/zlmage is ready 


O vmlinux: 是 Linux 进 行 编译 和 连接 之 后 生成 的 ELF 格 式 的 文件 。 

口 Image: 是 未 经 过 压缩 的 二 进 制 文件 。 

口 piggy: 是 一 个 解压 缩 程序 。 

О zImage: 是 解压 缩 程序 和 压缩 内 核 的 组 合 。 

在 Android 源 代码 的 根 目录 中 ,vmlinux 和 zImage 分 别 对 应 Android 代码 prebuilt 中 预 编译 的 ARM 
内 核 。 使 用 zImage 可 以 替换 prebuilt 中 “prebuilt/android-arm/” 目 录 下 的 goldfish_defconfig， 此 文件 的 


主要 片断 如 下 所 示 。 
CONFIG_ARM=y 
# 
# System Type 
# 


CONFIG_ARCH_GOLDFISH=y 

# 

# Goldfish options 

# 

CONFIG_MACH_GOLDFISH=y 

# CONFIG_MACH_GOLDFISH_ARMV7 is not set 

因为 Goldfish 是 ARM 处 理 器 ， 所 以 CONFIG_ARM 宏 需 要 被 使 能 ，CONFIG_ARCH_GOLDFISH 
和 CONFIG MACH GOLDFISH 宏 是 Goldfish 处 理 器 这 类 机 器 使 用 的 配置 宏 。 

在 goldfish_defconfig 中 ， 与 Android 系统 相关 的 宏 如 下 所 示 。 

# 

# android 

# 

CONFIG ANDROID=y 

CONFIG ANDROID BUNDER IPC-y #binder ipc 驱动 程序 

CONFIG_ANDROID_ LOGGER=y #log 记录 器 驱动 程序 

#CONFIG ANDROID RAM CONSOLE is not set 

CONFIG_ANDROID_TIMED_OUTPUT=y ”# 定 时 输出 驱动 程序 框架 

CONFIG_ANDROID_LOW_MEMORY_KILLER=y 

CONFIG_ANDROID_PMEM=y # 物 理 内 存 驱动 程序 

CONFIG_ASHMEM=y # 匿 名 共享 内 存 驱 动 程序 

CONFIG_RTC_INTF_ALARM=y 

CONFIG_HAS_WAKELOCK=y 电源 管理 相关 的 部 分 wakelock 和 earlysuspend 

CONFIG_HAS_EARLYSUSPEND=y 

CONFIG_WAKELOCK=y 

CONFIG_WAKELOCK_STAT=y 

CONFIG_USER_WAKELOCK=y 

CONFIG_EARLYSUSPEND=y 

goldfish defconfig 配置 文件 中 , 另外 有 一 个 宏 是 处 理 器 虚拟 设备 的 “驱动 程序 ” 其 内 容 如 下 所 示 。 

CONFIG MTD_GOLDFISH_NAND=y 

CONFIG_KEYBOARD_GOLDFISH_EVENTS=y 

CONFIG_GOLDFISH_TTY=y 


[OR 
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CONFIG_BATTERY_GOLDFISH=y 
CONFIG FB GOLDFISH-y 
CONFIG MMC GOLDFISH-y 
CONFIG RTC DRV GOLDFISH-y 


在 Goldfish 处 理 器 的 各 个 配置 选项 中 ， 体 系 结构 和 Goldfish 的 虚拟 驱动 程序 是 基于 标准 Linux 的 
内 容 的 驱动 程序 框架 ， 但 是 这 些 设 备 在 不 同 的 硬件 平台 的 移植 方式 不 同 ，Android 专用 的 驱动 程序 是 
Android 中 特有 的 内 容 ， 非 Linux 标准 ， 但 是 和 硬件 平台 无 关 。 
和 原 Linux 内 核 相 比 ，Android 内 核 增加 了 Android 的 相关 Driver， 对 应 的 目录 如 下 所 示 。 
kernel/drivers/android 
主要 分 为 以 下 几 类 Driver. 
Android IPC 系 统 : Binder (binder.c). 
Android 日 志 系 统 : Logger (logger.c)。 
Android 电源 管理 : Power (power.c)。 
Android 闹钟 管理 ，Alarm (alarm.c)。 
Android 内 存 控制 台 : Ram console (ram console.c). 
Android 时 钟 控制 的 gpio: Timed gpio (timed_gpio.c)。 
对 于 本 书 讲解 的 驱动 程序 开发 来 说 ， 我 们 比较 关心 的 是 Goldfish 平台 下 相关 的 驱动 文件 ， 上 有 具体 说 
明 如 下 。 
(1) 字符 输出 设备 : 
kernel/drivers/char/goldfish_tty.c 
(2) 图 像 显 示 设备 〈Frame Buffer): 
kernel/drivers/video/goldfishfb.c 
(3) 键盘 输入 设备 文件 : 
kernel/drivers/input/keyboard/goldfish_events.c 
(4) RTC (Real Time Clock) 设备 文件 : 
kernel/drivers/rtc/rtc-goldfish.c 
(5) USB Device 设备 文件 : 
kernel/drivers/usb/gadget/android adb.c 
(6) SD 卡 设备 文件 : 
kernel/drivers/lmmc/host/goldfish.c 
(7) FLASH 设备 文件 : 
kernel/drivers/mtd/devices/goldfish nand.c 
kernel/drivers/mtd/devices/goldfish nand reg.h 
(8) LED 设备 文件 : 
kernel/drivers/leds/ledtrig-sleep.c 
(9) 电源 设备 : 
kernel/drivers/power/goldfish battery.c 
(10) 音频 设备 : 
kernel/arch/arm/mach-goldfish/audio.c 
(OD 电源 管理 : 
kemel/arch/arm/mach-goldfish/pm.c 
(12) 时 钟 管理 : 
kernel/arch/arm/mach-goldfish/timer.c 


oOooooo 


М аяа 


2.5.2 ”获取 MSM 内 核 代 码 


在 目前 市 面 中 ， 谷 歌 的 手机 产品 G1 是 基于 MSM 内 核 的 ，MSM 是 高 通 公司 的 应 用 处 理 器 ， 在 
Android 代码 库 中 公开 了 对 应 的 MSM 的 源 代 码 。 在 Android 开源 工程 的 代码 仓库 中 ， 使 用 git 工具 得 
到 MSM 内 核 代 码 的 命令 如 下 所 示 。 

$ git clone git://android.git.kernel.org/kernel/msm.git 


2.5.3 获取 OMAP 内 核 代 码 


OMAP 是 德州 仪器 公司 的 应 用 处 理 器 ， 为 Android 使 用 的 是 OMAP3 系列 的 处 理 器 。 在 Android 


代码 库 中 公开 了 对 应 的 MSM 的 源 代码 ， 使 用 git 工具 得 到 MSM 内 核 代码 的 命令 如 下 所 示 。 
$ git clone git://android.git.kernel.org/kernel/omap.git 


2.5.4 编译 Android 的 Linux 内 核 


了 解 了 上 述 3 类 Android 内 核 后 ， 下 面 开始 讲解 编译 Android 内 核 的 方法 。 在 此 以 Ubuntu 8.10 为 
例 ， 完 整编 译 Android 内 核 的 流程 如 下 所 示 。 
(1) 构建 交叉 编译 环境 
Android 的 默认 硬件 处 理 器 是 ARM， 因 此 我 们 需要 在 自己 的 机 器 上 构建 交叉 编译 环境 。 交 又 编 译 
器 GNU Toolchain for ARM Processors 下 载 地 址 如 下 所 示 。 
http://www.codesourcery.com/gnu_toolchains/arm/download.html 
单 击 GNU/Linux 对 应 的 链接 ， 输 入 验证 邮箱 后 可 以 获得 下 载 地 址 ， 如 图 2-16 所 示 。 


Recommended Release 


This is a fully-validated update to a previous release. This update contains corrections for important defects and other 
improvements 


Download Sourcery CodeBench Lite 5.1 2012.03-117 


Available Releases 


This table lists all releases for download. 


Release Target Platform | Status | Date 

Sourcery CodeBench Lite 5.1 2012.03.117 GNU/Linux Update 2013-09-23 
Sourcery CodeBench Lite 2012.03-104 GNU/Linux Update 2013-04-02 
Sourcery CodeBench Lite 20120393 GNU/Linux Update 2012-11-19 
Sourcery CodeBench Lite 2012.03.66 GNU/Linux Release 2012.06.29 


2-16 ”提示 在 邮件 中 得 到 下 载 地 址 
把 下 载 到 的 “gnu.tarbz2” 文 件 解压 到 一 目录 下 ， 例 如 “~/programes/”， 并 加 入 PATH 环境 变量 ; 


vim ~/.bashrc 
然后 添加 : 
ARM_TOOLCHIAN=~/programes/arm-2008q3/bin/ 
export PATH=${PATH}:${ARM_TOOLCHIAN}; 
保存 后 并 执行 “soure~/,bashrc” 命 令 。 


e 
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(2) 获取 内 核 源 码 
源码 地 址 如 下 所 示 。 
http://code.google.com/p/android/downloads/list 
选择 的 内 核 版 本 要 与 选用 的 模拟 器 版 本 尽量 一 致 。 下 载 后 并 解压 后 得 到 kernel.git 文件 夹 : 
tar -xvf -/download/linux-3.2.5-android-4.3 r1.tar.gz 
(3) 获取 内 核 编译 配置 信息 文件 
编译 内 核 时 需要 使 用 configure， 通 常 configure 有 很 多 选项 ， 我 们 往往 不 知道 需要 哪些 选项 。 在 运 
ÍT Android 模拟 器 时 ， 有 一 个 文件 “/proc/config.gz”， 这 是 当前 内 核 的 配置 信息 文件 ， 把 config.gz 获取 
并 解压 放 到 “kernel.giW” 下 ， 然 后 改名 为 .config。 命 令 如 下 所 示 。 
cd kernel.git/ 
emulator & 
adb pull /proc/config.gz 
gunzip config.gz 
mv config .config 
(4) 修改 Makefile 
修改 195 行 的 代码 : 
CROSS COMPILE = arm-none-linux-gnueabi- 
将 CROSS COMPILE 值 改 为 arm-none-linux-gnueabi-， 这 是 我 们 安装 的 交叉 编译 工具 链 的 前 绥 ， 
修改 此 处 意 在 告诉 make 在 编译 时 要 使 用 该 工具 链 。 然 后 注释 掉 562 和 563 行 的 如 下 代码 : 
edu BUILD ID = $(patsubst -WI$(comma)%,%,/ 
$(call Id-option, -WI$(comma)-—build-id, )) 
Dane КЕККЕ НЫ MEE. 因为 目前 版 本 的 Android 内 核 不 支持 该 选项 。 
(5) 编译 
使 用 make 进行 编译 ， 并 同时 生成 zImage: 
LD arch/arm/boot/compressed/vmlinux 
OBJCOPY arch/arm/boot/zimage 
Kernel: arch/arm/boot/zlmage is ready 
这 样 生 成 zimage 大 小 为 1.23M,android- sdk-linux х86-4.3 rl/tools/lib/images/kemel-qemu 是 1.24M. 
(6) 使 用 模拟 器 加 载 内 核 测 试 
命令 如 下 所 示 : 
cd android/out/cupcake/out/target/product/generic 


emulator -image system.img -data userdata.img -ramdisk ramdisk.img -kernel ~/project/android/kernel.git/ 
arch/arm/boot/zimage & 


到 此 为 止 ， 模 拟 器 就 加 载 成 功 了 。 


63 © ШР Android 应 用 开发 环境 


应 用 层 位 于 Android 体系 的 最 顶层 ， 通 常 使 用 Java 语言 进行 开发 。 平 常 说 的 Android 应 用 开发 是 
指 开发 能 在 Android 系统 上 运行 的 程序 ， 例 如 在 手机 中 经 常 使 用 的 斗 地 主 游戏 、 谷 歌 地 图 等 程序 都 属 
于 应 用 开发 展 。 本 章 将 详细 讲解 搭建 Android 应 用 开发 环境 的 知识 ， 为 读者 学 习 后 面 知 识 打 下 基础 。 


3.1 搭建 前 的 准备 
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Android SDK 是 开发 Android 应 用 程序 所 必须 具备 的 工具 , 在 搭建 之 前 需要 先 确定 基于 Android 应 
用 软件 所 需要 开发 环境 的 要 求 ， 具 体 如 表 3-1 所 示 。 


表 3-1 开发 系统 所 需求 的 参数 


Windows XP 以 上 或 Vista 
Mac OS X 10.4.8+Linux 根据 自己 的 电脑 自行 选择 选择 自己 最 熟悉 的 操作 系统 
Ubuntu Drapper 以 上 


软件 开发 包 选择 最 新 版 本 的 SDK 


Eclipse3.3 (Europa)，3.4 
IDE Eclipse IDE+ADT (Ganymede) ADT (Android 选择 for Java Developer 
Development Tools) 开发 插件 


Java SE Development Kit 5 或 6 单独 的 IRE 不 可 以 的 ， 必 须要 有 
其 他 JDKApache Ant Linux 和 Mac 上 使 用 Apache Ant | JDK， 不 兼容 Gnu Java 编译 器 
1.6.5+, Windows 上 使 用 1.7+ 版 本 (gcj) 


截止 到 目前 ， 最 新 版 本 是 5.0 


Android 工具 是 由 多 个 开发 包 组 成 的 ， 具 体 说 明 如 下 : 

Q JDK: 可 以 到 网 址 http://java.sun.com/javase/downloads/index.jsp 下 载 。 

Q Eclipse Europa) : 可 以 到 网 址 http://www.eclipse.org/downloads/ 下 载 Eclipse IDE for Java Developers. 
口 Android SDK: 可 以 到 网 址 http://developer.android.com 下 载 。 

口 还 有 对 应 的 开发 插件 。 


3.2 安装 JDK 


Ши 知 识 点 讲解 : 光盘 :视频 \ 知 识 点 第 3 章 \ 安 装 JDK.avi 
JDK (Java Development Kit) 是 整个 Java 的 核心 ， 包括 了 Java 运行 环境 、Java 工具 和 Java 基础 的 
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类 库 。JDK 是 学 好 Java 的 第 一 步 ， 是 开发 和 运行 Java 环境 的 基础 ， 当 用 户 要 对 Java 程序 进行 编译 的 时 
候 ， 必 须 先 获得 对 应 操作 系统 的 JDK， 和 否则 将 无 法 编译 Java 程序 。 在 安装 IDK 之 前 需要 先 获得 IDK, 
获得 IDK 的 操作 流程 如 下 。 

(1) 登录 Oracle 官方 网 站 ， 网 址 为 http://developers.sun.com/downloads/， 如 图 3-1 所 示 。 


Downloads | Store Support Training Partners ^ About | 
Databases Server and Storage Systems 
Database 11, Solar 
- ы a Java for Developers 
Database 11g Release 2 Linux and VM 
Express Edition. подна Java for Your Computer 
MySQL See JavaFX 
Berkeley DB Oracle Solaris 
instant Client Developer Tools MySQL 
Application Express SQL Developer Fusion Middleware 11g 
See Al Database 119 
TE ind ADF. 
лаана Pre-Buit Developer VMs 
Developer Tools for Visual Studio 
ma Enterprise Pack for Eclipse 
Fusion Middleware 11g 
(псі WebLogic) е ы Free Open Source Software 
JRockt Ызы Partner Demo Software 
‘SOA Sute 
Applications. 
See All 
E-Business Sute, 
PeopleSoft, JD Edwards, 
Enterprise Management Siebel CRM 
Enterprise Manager Agie 
Application Testing Sute Autovue 
See All See Al 
3-1 Oracle 官方 下 载 页 面 


(2) 在 图 3-1 中 可 以 看 到 有 很 多 版 本 ， 在 此 选择 当前 最 新 的 版 本 Java 7， 下 载 页 面 如 图 3-2 所 示 o 
G) 在 图 3-2 中 单 击 IDK 下 方 的 Download 按钮 ， 在 弹出 的 新 界面 中 选择 将 要 下 载 的 JDK， 笔 者 


在 此 选择 的 是 Windows X86 版 本 ， 如 图 3-3 所 示 。 


Development. 
Java Platform, Standard Edition не кит 
You must accept the Oracle Binary Code License Agreement for Java SE to download this 
Java SE Tu1 JDK JRE ec 
Wes. Leam 
menmi includes many security fixes. Learn ETRE PETER е c 
"What Java Do Мева?" You musthave acopy of | JDK7 Docs УВЕ 7 Doce 
the JRE (Java Runtime Environment) on your * installation Installation. Product  Flle Description File She Download 
system to run Java applications and apple's. To "instructions 一- Unux x86 77.27 MB Š jdk-7ut-sinuxi686.19m 
develop Java applications and applets, youneed — — Linux x86 92.17 MB 3 jdk-u1-inuxi586 tar cz 
the JDK Uava Development Kit which incudes + ReadMe ReadMe Linux x64 7791MB }йк-7о1-пих-б4лрт 
the JRE . Linux x64 9057 МВ $ jdi-Tu1-linuxx64 tar.gz 
Releaseliotes | * ReleaseNoles Solaris 86 15478 MB Š jdh-7ut-solaris-1686 a2 
* Oracle License | + Oracle License Solaris x86 94.75 MB Š jdi-7ut-solaris-i586 tar gz 
* Java SE * Java SE Solaris SPARC 157.81 MB Š jdk-7u1-solaris-sparciarZ 
Products Products ‘Solaris SPARC 99.48 МВ Š jdk-7u1-solaris-sparc.tar.gz 
ey Solaris SPARC 64-bit 16.27 MB Š jdk-7u1-solaris-sparcv9.tarZ 
* Third Pary * Thid Pat Solaris SPARC 64-bit 1237 MB Š jdk-7u1-solaris-sparo@ tar gz 
— — Solaris 64 1468 MB Š jdk-7ut-solars-x64 tarZ 
* Certified System • Certified System Solaris x64 9.38 МВ $ jdk-7u1-solaris-x64 tar.gz 
Configurations | Configurations Windows x86 79.46 MB Š jak-7ut-windows-i586 exe 
Windows x64 80.24 MB S jdiciut-windows-x64. exe 


32 IDK 下 载 页 面 


一 步 ” 按 钮 ， 如 图 3-4 所 示 。 


图 3-3 选择 Windows X86 版 本 
(4) 下 载 完 成 后 双击 下 载 的 “.exe” 文 件 开始 进行 安装 ， 将 弹出 安装 向 导 对 话 框 ， 在 此 单 击 “ 下 


(5) 弹出 自 定义 安装 路 径 对 话 框 ， 在 此 可 以 自 定义 选择 ， 如 图 3-5 所 示 。 


Android 外 设 开发 实战 


12 Java (Т) SE Developsent Kit T Update 1- Beta xj 


Ss Java ORACLE 


请 从 下 面 的 列表 中 先 押 要 安装 的 可 迁 功 能 。 安 装 完 成 后 ,您 可 以 使 用 "控制 面板 "中 的 添加/ 
遇险 程序 实用 程序 未 更 改 您 选择 的 功能 


欢迎 使 用 Java(TM) SE Development Kit 7 Update 1 安装 向 导 


E] 
Java(TM) SE Development Kt 7 Update 1 安装 得 序 正在 准备 安装 凋 导 ， TRASIE BER NAR RE 
ЧЕР ан. MEE. ostiis E pu 
Susi: 
C:\Program Fies Davalik.7.0. 01V BMW)... 
fi 
Es EA | a <+-®® вн 
图 3-4 “许可 证 协议 ”对 话 框 图 3-5 “安装 路 径 ” 对 话 框 


(6) 单 击 “ 下 一 步 ”按钮 后 开始 解压 缩 下 载 的 文件 ， 如 图 3-6 所 示 。 
(7) 完成 后 弹出 “目标 文件 夹 ” 对 话 框 ， 在 此 选择 要 安装 的 位 置 ， 如 图 3-7 所 示 。 


I eel iC 
取消 T-$0» 
3-6 解压 缩 下 载 的 文件 图 3-7 “目标 文件 夹 ” 对 话 框 


(8) 单 击 “ 下 一 步 ” 按钮 后 开始 正式 安装 ， 如 图 3-8 所 示 。 
(9) 完成 后 弹出 “完成 ”对 话 棋 ， 单 击 “ 完 成 ” 接 包 所 完成 整个 安 装 过 程 ， 如 图 3.9 所 示 。 


i Java (ТВ) SE Devel 


ORACLE oracle 


Java( TH) SE Development Kit 7 Update 1 已 成 功 安装 
ии 
тазалана, ените: 
"Pss. ilis 
Billi Devi R J ТЕК ose PREPS, КЕИШ NOS 
3 Billion Devices Run Java жининен 


MU ERU GRE ан RSE, MRT DK 产品 注册 表单 。 如 果 您 
不 注册 , 则 不 保存 以 上 信息 。 


有 关注 册 所 收集 的 数据 以 及 这 些 数据 的 莹 理 和 使 用 方式 的 更 多 信息 ， 请 参见 ' 产 品 
注册 信息 页面 ， 


BEMAR 


图 3-8 继续 安装 图 3-9 完成 安装 
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完成 安装 后 可 以 检测 是 否 安装 成 功 ， 检 测 方法 是 选择 “开始 ”| “运行 ”命令 ， 在 运行 框 中 输 
入 cmd 并 回 车 ， 在 打开 的 CMD 窗口 中 输入 java -version， 如 果 显 示 如 图 3-10 所 示 的 提示 信息 ， 则 
说 明 安装 成 功 。 


п 


Environment (build 1.7.8 81-b885 
Java HotSpot TIM> Client UM (build 21.1-b02, mixed mode, sharing) 


C:\Documents and Settings\Administrator> 


图 3-10 CMD 窗口 

如 果 检 测 没有 安装 成 功 ， 需 要 将 其 目录 的 绝对 路 径 添加 到 系统 的 PATH 中 。 具 体 做 法 如 下 。 

CD 右键 单 击 “我 的 电脑 ”在 弹出 的 快捷 菜单 中 选择 “属性 ”| “高 级 ”命令 ， 单 击 下 面 的 “ 环 
境 变量 ”按钮 ， 在 下 面 的 “系统 变量 ”处 选择 新 建 ， 在 弹出 对 话 框 的 “变量 名 ”处 输入 JAVA НОМЕ, 
“变量 值 ”中 输入 刚才 的 目录 ， 比 如 设置 为 Vavajdkl1.7.0_ .01， 如 图 3-11 所 示 。 

(2) 再 次 新 建 一 个 变量 名 为 classpath， 其 变量 值 如 下 所 示 : 

.;%JAVA_HOME%/lib/rtjar:%JAVA_HOME%/lib/toolsjar 

单 击 “ 确 定 ” 按 钮 找到 PATH 的 变量 ， 双 击 或 单 击 编辑 ， 在 变量 值 最 前 面 添加 如 下 值 : 

%JAVA_HOME%/bin; 

具体 如 图 3-12 所 示 。 


ЁГЕ xl КЕЕ Е 
变量 名 0) [TAVA НОНЕ E: nu classpath 
EIB (v) F \Java\ j dk. 7.0 01 жаву ib/rt. jar; JAVA HOMEK/1ib/ tools. jar 
we | m mis 
图 3-11 设置 系统 变量 图 3-12 设置 系统 变量 


G) 再 选择 “开始 ”| “和 运行” 命令， 在 运行 框 中 输入 ста 并 回 车 ， 在 打开 的 CMD 窗口 中 输入 
java -version， 如 果 显 示 如 图 3-13 所 示 的 提示 信息 ， 则 说 明 安 装 成 功 。 


ment (build 1.7.0_01-b08 
build 21.1-b82, mixed m „ sharing? 


3-13 CMD 窗口 


注意 : 上 述 变 量 设置 中 ， 是 按照 笔者 的 安装 路 径 设置 的 ， 笔 者 安装 的 IDK 的 路 径 是 C:\Program 
Files\Java\jdk1.7.0_02. 


® 
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Фи 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 3 章 \ 获 取 并 安装 Eclipse 和 Android SDK.avi 
在 安装 好 IDK 后 , 接 下 来 需要 安装 Eclipse 和 Android SDK. Eclipse 是 进行 Android 应 用 开发 的 一 
个 集成 工具 , 而 Android SDK 是 开发 Android 应 用 程序 必须 具备 的 框架 。 在 Android 官方 公布 的 最 新 版 
本 中 ， 已 经 将 Eclipse 和 Android SDK 这 两 个 工具 进行 了 集成 ， 一 次 下 载 即 可 同时 获得 这 两 个 工具 。 
获取 并 安装 Eclipse 和 Android SDK 的 具体 步骤 如 下 。 
(1) 登录 Android 的 官方 网 站 http://developer.android.com/index.html， 如 图 3-14 所 示 。 


$} Developers Design Develop Distribute q 


Android 5.0 Lollipop 
The Android 5 0 update adds a variety of 


Matenal design interface, and much more 


Building Apps for Creating Apps with 
Wearables = Material Desigy 

Lean tres 2 ra hom үң at de te 
nd spe бид wa ie voce crm. = | ~ 


3-14 Android 的 官方 网 站 
(2) 单 击 页 面 中 部 的 Get the SDK 链接 ， 如 图 3-15 所 示 。 


Get the SDK » Browse Samples » Watch Videos » Manage Your Apps » 


3-15. Mii Get the SDK 链接 
(3) 在 弹出 的 新 页 面 中 单 击 Download the SDK 按钮 ， 如 图 3-16 所 示 。 


$ Developers 


Design Develop Distribute 


а 
Training — APlGuides — Reference Tools Google Services 
Developer Tools Get the Android SDK 
Download 


Setting Up the ADT 
Bundle 

Setting Up an 
Existing IDE 
Android Studio 


‘The Android SOK provides you the API libraries and 
developer tools necessary to build test, and debug 
apps for Android. 


youre a new Android developer, 


download the ADT Bundle to quickly start developing. 
apps: It includes the essential Android SDK 


c0 =. 
aoe 
BED а 
‘Workflow ‘With a single download, the ADT Bundie includes 
everything you need to begin developing apps 
= ery 
pcm 
us 


* Android SDK Tools 


3-16 š Download the SDK 按钮 
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(4) 在 弹出 的 Get the Android SDK 界面 中 选中 I have read and agree with the above terms and 
conditions 复 选 框 ， 然 后 在 下 面 的 单 选 按钮 中 选择 系统 的 位 数 。 例 如 笔者 的 机 器 是 32 位 的 ， 所 以 选中 
32-bit 单 选 按钮 ， 如 图 3-17 所 示 。 

(5) 单 击 图 3-17 hi SE 扩 钮 后 开始 下 载 工作 ， 下 载 的 目标 文件 是 一 个 压缩 包 ， 
如 图 3-18 所 示 。 


Before nstaling he Android SOK, you must apee to Ње folowing terms and conditions 


1.2 "Andro means the Android soñar stack 
‘Project whichis located и the folowing 


1 3"Gcogie" means Google nc. a Delamare corporation with principal piace of busines at 1600 Amphaheame [nen ES x 
Toten Maan Ven CASE Ure sines 
jol act bundlo wincowsy85.20130917zp 
E this License Ac vent 
кни a менн S J. = 
эле o use e SK jou mast et apes to na Lene ресто Yom ete he SDK youd ot 3 
Agreement mi 
а “Romay e 
дуне d ya же a person bared truces TS 
мүрү lt 
Оазяѕа 
r1 ea uiii pur ant rir i al ОтаккЕвњев 
ятни 
тыннар |= 
@ RET - ma 


图 3-17 Get the Android SDK 界面 图 3-18 开始 下 载 目标 文件 压缩 包 


(6) 将 下 载 得 到 的 压缩 包 进行 解压 ， 解 压 后 的 目录 结构 如 图 3-19 所 示 。 


D eclipse 2014/10/14 8:51 SARK 
点 sdk 2014/10/18 16:26 XAR 
[E] SDK Manager. exe 2014/1/3 3:24 应 用 程序 216 KB 


3-19 解压 后 的 目录 结构 


由 此 可 见 ,Android 官方 已 经 将 Eclipse #1 Android SDK 实现 了 集成 。 双 击 eclipse 目录 中 的 eclipse.exe 
可 以 打开 Eclipse， 界 面 效 果 如 图 3-20 所 示 。 


^ Әсте + à. dl 


сэв э D Leading data feda. 49: 000 NEN S 


320 打开 Eclipse 后 的 界面 效果 
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(7) 打开 Android SDK 的 方法 有 两 种 ， 第 一 种 是 双击 下 载 目录 中 的 SDK Manager.exe 文件 ， 第 二 


种 是 在 Eclipse 工具 栏 中 单 击 到 图标。 打开 后 的 效果 如 图 3-21 所 示 。 


laid 
no Lyn 
DO decusentatice for аә T Preview SOK 1 1 Installed E 
| Shor IV pistes F аё Select Bee or Updates Да 13 рар. 
Г mas Dat Ш Diete 4 packages 


Done loading packages. o 


3-21 打开 Android SDK 后 的 界面 效果 


在 打开 Android SDK 后 的 界面 中 可 知 ， 当 前 最 新 的 Android SDK 版 本 是 5.0. 


注意 : 


快速 安装 SDK 通过 Android SDK Manager 在 线 安装 的 速度 非常 慢 , 而 且 有 时 容易 挂 掉 。 其 实 我 
们 可 以 先 从 网 络 中 寻找 到 SDK 资源 ， 用 迅雷 等 下 载 工 具 下 载 后 ， 将 其 放 到 指定 目录 后 就 可 以 完 
成 安装 .具体 方法 是 先 下 载 android-sdk-windows( 可 以 更 新 的 那 种 ), 然后 在 android-sdk-windows 
下 双击 setup.exe， 在 更 新 的 过 程 中 会 发 现 安装 Android SDK 的 速度 是 1Kib/s， 此 时 打开 迅雷 ， 
分 别 输入 下 面 的 地 址 : 


https://dl-ssl.google.com/android/repository/platform-tools_r05-windows. zip 
https://dl-ssl.google.com/android/repository/docs-3.1_r03-linux.zip 
https://dl-ssl.google.com/android/repository/android-2.2 r03-windows.zip 
https://dl-ssl.google.com/android/repository/android-2.3.3 r03-linux.zip 
https://dl-ssl.google.com/android/repository/android-2.1 r03-windows.zip 
https://dl-ssl.google.com/android/repository/samples-2.3.3 r03-linux.zip 
https://dl-ssl.google.com/android/repository/samples-2.2 r03-linux.zip 
https://dl-ssl.google.com/android/repository/samples-2.1 r03-linux.zip 
https://dl-ssl.google.com/android/repository/compatibility r02.zip 
https://dl-ssl.google.com/android/repository/tools r13-windows.zip 
https://dl-ssl.google.com/android/repository/google apis-10 r02.zip 
https://dl-ssl.google.com/android/repository/android-2.3.1 r03-linux.zip 
https://dl-ssl.google.com/android/repository/usb driver r04-windows.zip 
https://dl-ssl.google.com/android/repository/googleadmobadssdkandroid-4.1.0.zip 
https://dl-ssl.google.com/android/repository/market licensing-r01.zip 
https://dl-ssl.google.com/android/repository/market billing r01.zip 
https://dl-ssl.google.com/android/repository/google apis-8 r02.zip 
https://dl-ssl.google.com/android/repository/google apis-7 r01.zip 
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https://dl-ssl.google.com/android/repository/google apis-9 r02.zip. 


可 以 继续 根据 自己 的 开发 要 求 选择 不 同 版 本 的 API 

下 载 完 后 将 它们 复制 到 android-sdk-windows/Temp 目录 下 , 然后 再 运行 setup.exe, 选中 需要 的 АРІ 
选项 ， 会 发 现 马上 就 安装 好 了 。 记 得 把 原始 文件 保留 好 ， 因 为 放 在 temp 目录 下 的 文件 装 好 后 立 
刻 就 没有 了 。 


3.4 安装 ADT 


Ши 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 3 章 \ 安 装 ADTavi 
Android 为 Eclipse 定制 了 一 个 专用 插件 Android Development Tools m 
(CADT)， 此 插件 为 用 户 提供 了 一 个 强大 的 开发 Android 应 用 程序 的 综合 环 
境 。ADT 扩 展 了 Eclipse 的 功能 ， 可 以 让 用 户 快速 地 建立 Android 项 目 ， 创 
建 应 用 程序 界面 。 要 安装 Android Development Tools plug-in, 需要 首先 打开 
Eclipse IDE， 然 后 进行 如 下 操作 : 
(1) 打开 Eclipse 后 ， 在 菜单 栏 中 选择 Help | Install New Software 命令 ， 
如 图 3-22 所 示 。 
(2) 在 弹出 的 对 话 框 中 单 击 Add 按钮 ， 如 图 3-23 所 示 。 图 3.22 添加 插件 


Available Software 


Select а site or enter the location of a site. 


323 添加 插件 


(3) 在 弹出 的 Add Site 对 话 框 中 分 别 输入 名 字 和 地 址 ， 名 字 可 以 自己 命名 ， 例 如 “123”， 但 是 
在 Location 文本 框 中 必须 输入 插件 的 网 络 地 址 http://dl-ssl.google.com/Android/eclipse/, 如 图 3-24 所 示 。 
(4) 单 击 OK 按钮 ， 此 时 在 Install 对 话 框 将 会 显示 系统 中 可 用 的 插件 ， 如 图 3-25 所 示 。 


Available Software 
Check the cans that you visà te asta 


a 
EG has pervert lois C 9 5 АЯШСА 


图 3-24 设置 地 址 图 3-25 插件 列表 


(5) 选中 Android DDMS 和 Android Development Tools 复 选 框 ， 然 后 单 击 Next 按钮 进入 安装 界 
面 ， 如 图 3-26 所 示 。 


| Review Licenses 
| пишен mast be reruwed bitore the noftrae can be иш Thor incheder сезиз ta softere regret o 
tinplate the vested 


фут етен Teri [FER OI eel 
з 3 0 WO09IDI5-(S00reay 
3 3 0 WOD9IDIS-0500ress 
3 3 0 хаю. 
3 зо чйкзйлзчзи низ 
Фуу Tuk List Gaguired) 3 3 O. v£0091015-0500- 
айу. Tasi Focused Interface Mee 3 3 0 ve009l0l5-0500-es Pta 
nA trite 1 to va003l0l5-05000-c РО 


图 3-26 插件 安装 界面 
(6) 选中 Iaccept... 单 选 按钮 ， 单 击 Finish 按钮 ， 开 始 安装 ， 如 图 3-27 所 示 。 


Install Blocked: The user operati... for background work to complete.) 
[id 


Fetching con. android ide. eclipse. а... adt, 0. 9. 9. v201009221407-60953. jar 


327 开始 安装 


I Be Android mAAR ЩЩ 


注意 : 在 上 个 步骤 中 ， 可 能 会 发 生计 算 插件 占用 资源 情况 ， 过 程 有 点 慢 。 完 成 后 会 提示 重启 Eclipse 来 
加 载 插件 ， 等 重启 后 就 可 以 用 了 。 并 且 不 同 版 本 的 Eclipse 安装 插件 的 方法 和 步骤 是 不 同 的 ， 但 
是 基本 上 大 同 小 异 ， 读 者 可 以 根据 操作 提示 自行 解决 。 


3.5 验证 设置 
М 知识 点 讲解 光盘 :视频 \ 知 识 点 \ 第 3 章 \ 验 证 设置 .avi 


本 章 前 面 内 容 已 经 讲解 了 搭建 安装 Android 基本 环境 的 知识 ， 在 完成 安装 之 后 ， 还 需要 一 些 具体 验 
证 和 设置 工作 ， 本 节 将 详细 讲解 验证 和 设置 Android 开发 环境 的 基本 知识 。 


3.5.1 ЖЕ Android SDK Home 


当 完 成 上 述 插件 装备 工作 后 ， 此 时 还 不 能 使 用 Eclipse 创建 Android 项 
目 ， 我 们 还 需要 在 Eclipse 中 设置 Android SDK 的 主 目录 。 
(1) 打开 Eclipse, 在 菜单 中 依次 选择 Windows | Preferences 命令 ， 如 
3-28 所 示 。 
(2) 在 弹出 的 界面 左 侧 可 以 看 到 Android 项 ， 选 中 Android 项 后 ， 在 
右 侧 设 定 Android SDK 所 在 目录 为 SDK Location, Jil; OK 按钮 完成 设置 ， 图 3.28 选择 Preferences 命令 
如 图 3-29 所 示 。 


3-29 WE Android SDK 所 在 目录 


3.52 ”验证 开发 环境 


经 过 前 面 步 骤 的 讲解 ， 一 个 基本 的 Android 开发 环境 算是 搭建 完成 了 。 都 说 实践 是 检验 真理 的 唯 
一 标准 ， 下 面 通过 新 建 一 个 项 目 来 验证 当前 的 环境 是 否 可 以 正常 工作 。 


Aros sae RE 


(1) 打开 Eclipse， 在 菜单 中 依次 选择 File | New | Project 命令 ， 在 弹出 的 对 话 框 中 可 以 看 到 Android 
类 型 的 选项 ， 如 图 3-30 所 示 。 
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o 7 Heat? Conceal 
图 3-30 新 建 项 目 


(2) 在 图 3-30 中 选择 Android 选项 ， 单 击 Next 按钮 后 打开 New Android Application 对 话 框 ， 在 
对 应 的 文本 框 中 输入 必要 的 信息 ， 如 图 3-31 所 示 。 
(3) 单 击 Finish 按钮 后 Eclipse 会 自动 完成 项 目的 创建 工作 ， 最 后 会 看 到 如 图 3-32 所 示 的 项 目 结构 。 
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图 3-31 New Android Application 对 话 框 图 3-32 项 目 结构 


3.6 Android 模拟 器 详解 


И 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 3 章 \Android 模拟 器 详解 .avi 
我 们 都 知道 程序 开发 需要 调试 ， 只 有 经 过 调试 之 后 才能 知道 我 们 的 程序 是 否 正确 运行 。 作 为 一 款 
手机 系统 ， 我 们 怎么 样 才能 在 电脑 平台 上 调试 Android 程序 呢 ? 不 用 担心 ， 谷 歌 为 我 们 提供 了 模拟 器 


e 
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来 解决 我 们 担心 的 问题 。 所 谓 模拟 器 ， 就 是 指 在 电脑 上 模拟 安 卓 系统 ， 可 以 用 这 个 模拟 器 来 调试 并 运 


行 开发 的 Android 程序 。 开 发 人 员 不 需要 一 个 真实 的 Android FHL, 
即 可 开发 出 应 用 在 手机 上 面 的 程序 。 


3.6.1 创建 Android 虚拟 设备 (AVD) 


只 通过 电脑 即 可 模拟 运行 一 个 手机 ， 


AVD 全 称 为 Android 虚拟 设备 CAndroid Virtual Device)， 每 个 AVD 模拟 了 一 套 虚拟 设备 来 运行 


Android 平台 ， 这 个 平台 至 少 要 有 自己 的 内 核 、 系 统 图 像 和 数据 分 
据 以 及 外 观 显示 等 。 
Android 模拟 器 不 能 完全 替代 真 机 ， 具 体 来 说 有 如 下 差异 。 


模拟 器 不 支持 USB 连 接 。 

模拟 器 不 支持 相机 /视频 捕捉 。 

模拟 器 不 支持 音频 输入 (捕捉 )， 但 支持 输出 ( 重 放 ) 。 
模拟 器 不 支持 扩展 耳机 。 

模拟 器 不 能 确定 连接 状态 。 

模拟 器 不 能 确定 电池 电量 水 平和 交流 充电 状态 。 

模拟 器 不 能 确定 SD 卡 的 插入 /弹出 。 

模拟 器 不 支持 蓝牙 。 

创建 AVD 的 基本 步骤 如 下 。 

(1) 单 击 Eclipse 菜单 中 的 图 标题 ， 如 图 3-33 所 示 。 


ооооооовоо 


Eile Edit Run Source Refactor Navigate Search Project Window Help 


区 ， 还 可 以 有 自己 的 SD 卡 和 用 户 数 


模拟 器 不 支持 呼叫 和 接听 实际 来 电 ， 但 可 以 通过 控制 台 模拟 电话 呼叫 ( 呼 入 和 呼出 ) 。 
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Ё 3-33 Eclipse 窗口 


(2) 在 弹出 的 Android Virtual Device (AVD) Manager 对 话 框 中 选择 Android Virtual Devices 选项 


卡 ， 如 图 3-34 所 示 。 


19) 


Android 外 设 开发 实战 


i 


эчә 


regere аме Viral Device X з мем orte Device thet feel te Lesl. Click “Bytes аө see the error 


图 3-34 Android Virtual Device (AVD) Manager 对 话 框 

在 其 中 的 列表 框 中 列 出 了 当前 已 经 安装 的 АУР 版 本 , 我 们 可 以 通过 右 侧 的 按钮 来 创建 、 删 除 或 修 
改 AVD。 主 要 按钮 的 具体 说 明 如 下 。 
а [es] 人 建 一 个 新 的 AVD, 单 击 此 按钮 在 弹出 的 界面 中 可 以 创建 一 个 新 AVD, 如 图 3-35 所 示 。 


a : 修改 已 经 存在 的 AVD。 
O Шш |; 删除 已 经 存在 的 AVD。 
Q = : 启动 一 个 AVD 模 拟 器 。 
Р 
= 
a 
E! 
3 
E! 
2] 
Interna ira р ua z] 
P © зия: [PT Po z] 
C nu: [ [ыш 
крш 


3-35 新 建 AVD 界面 
ЖЕ: 我 们 可 以 在 CMD 中 创建 或 删除 AVD， 例 如 可 以 按照 如 下 CMD 命令 创建 一 个 AVD。 
android create avd -name <your_avd_name> --target <targetID> 


其 中 your avd name 是 需要 创建 的 AVD 的 名 字 ，CMD 窗口 如 图 3-36 所 示 。 


3-36 CMD 窗口 


3.6.2 


流程 如 下 。 


CD 选择 图 3-34 列表 


启动 AVD 模拟 器 


对 于 Android 程序 的 开发 者 来 说 ， 模 拟 器 的 推出 给 
测试 上 带 来 了 很 大 的 便利 。 无 论 在 Windows 下 还 是 Linux F, Android 
模拟 器 都 可 以 顺利 运行 , 并 且 官 方 提供 了 Eclipse 插件 , n 
成 到 Eclipse 的 IDE 环境 。Android SDK 中 包含 的 模拟 器 的 功能 非常 齐 
全 ， 电 话 本 、 通 话 等 功能 都 可 正常 使 用 (当然 你 没 办 法 真 的 从 这 里 打 电 
W), 甚至 其 内 置 的 浏览 器 和 Maps 都 可 以 联网 。 用 户 可 以 使 用 键盘 输入 ， 
鼠标 单 击 模拟 器 按键 输入 ， 甚 至 还 可 以 使 用 鼠标 单 击 、 拖 动 屏幕 进行 操 
纵 。 模 拟 器 在 电脑 上 模拟 运行 的 效果 如 图 3-37 Bros o 

在 调试 的 时 候 我 们 需要 启动 АУР 模拟 器 ， 启 动 АУР 模拟 器 的 基本 


出 Launch Options 对 话 框 ， 如 图 3-38 所 示 。 


(2) 单 击 Launch 按钮 后 将 会 运行 名 为 first 的 模拟 器 ， 运 行 界面 效 


果 如 图 3-39 所 示 。 
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图 3-38 Launch Options 对 话 框 
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图 3-37 模拟 器 


图 3-39 模拟 运行 成 功 
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学 习 编 程 不 能 打 无 把 握 之 仗 ， 学 习 Android 外 设 项 目 开发 也 是 如 此 。 要 想 真正 精通 开发 Android 
Sheesh A REAPER ARAN, AMELIE IR A Android 框架 方面 的 知识 ， 而 且 还 需要 掌握 Android 
顶层 应 用 程序 开发 的 基本 知识 。 本 章 将 详细 讲解 Android 系统 的 体系 结构 ， 了 解 外 设 项 目 开发 所 必须 
具备 的 基本 技术 ， 为 读者 学 习 后 面 的 知识 打下 基础 。 


4.1 Android 系统 架构 介绍 


ШМ 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 4 章 \Android 系统 架构 介绍 .avi 

Android 是 一 个 移动 设备 的 开发 平台 , 其 软件 层次 结构 包括 操作 系统 (OS)、 中 间 件 (MiddleWare) 
和 应 用 程序 (Application)。 整 个 Android 系统 的 层次 结构 分 为 4 层 ， 自 下 而 上 分 别 如 下 。 

о 操作 系统 层 (OS). 

口 各 种 库 (Libraries) 和 Android 运行 环境 (RunTime) 。 

口 应 用 程序 框架 (Application Framework) 。 

口 应 用 程序 (Application) 。 

上 述 各 个 层 的 具体 结构 如 图 4-1 所 示 。 


4-1 Android 操作 系统 的 组 件 结构 图 


为 了 更 加 深入 理解 Android Ж ЭШИ ЖЕЙ, 初学 者 们 很 有 必要 了 解 Android 系统 的 整体 架构 ， 了 
解 它 的 具体 组 成 。 只 有 这 样 才能 知道 Android 究竟 能 干什么 ， 我 们 所 要 学 的 是 什么 。 本 节 简 要 讲解 
Android 系统 架构 的 基本 知识 。 


4.1.1 底层 操作 系统 层 (OS) 


因为 Android 基于 Linux 内 核 , 所 以 Android 使 用 Linux 作为 操作 系统 。Linux 是 一 种 标准 的 技术 ， 
Linux 也 是 一 个 开放 的 操作 系统 。Android 对 操作 系统 的 使 用 包括 核心 和 驱动 程序 两 部 分 ，Android 的 
Linux 核心 为 标准 的 Linux 内 核 ，Android 更 多 的 是 需要 一 些 与 移动 设备 相关 的 驱动 程序 。 主 要 的 驱动 
如 下 。 


显示 驱动 (Display Driver) : 常用 基于 Linux 的 帧 缓冲 〈Frame Buffer) 驱动 。 

Flash 内 存 驱 动 (Flash Memory Driver) : 是 基于 MTD 的 Flash 驱 动 程序 。 

照相 机 驱动 (Camera Driver) : 常用 基于 Linux 的 v41 (Video for) 驱动 。 

音频 驱动 (Audio Driver) : 常用 基于 ALSA (Advanced Linux Sound Architecture， 高 级 Linux 
声音 体系 ) 驱动 。 

WiFi 驱 动 (Camera Driver) : 基于 IEEE 802.11 标 准 的 驱动 程序 。 

键盘 驱动 (KeyBoard Driver) : 作为 输入 设备 的 键盘 驱动 。 

蓝牙 驱动 (Bluetooth Driver) : 基于 IEEE 802.15.1 标 准 的 无 线 传输 技术 。 

Binder IPC 驱 动 : Android 一 个 特殊 的 驱动 程序 , 具有 单独 的 设备 节点 , 提供 进程 间 通 信 的 功能 。 
Power Management( 能 源 管理 ) : 管理 电池 电量 等 信息 。 


4.1.2 Я (Libraries) 和 Android 运行 环境 (RunTime) 
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ooooo 


Android 的 本 层次 分 成 两 个 部 分 ， 一 个 是 各 种 库 ， 另 一 个 是 Android 12 4T ABE. AVON e 
入 式 系统 ， 相 当 于 中 间 件 层次 。 本 层 的 内 容 大 多 是 使 用 C 和 C++ 实现 的 。 其 中 包含 的 各 种 库 如 下 。 
О СЖ: C 语 言 的 标准 库 ， 也 是 系统 中 一 个 最 为 底层 的 库 ，C 库 是 通过 Linux 的 系统 调用 来 实现 。 
О 多 媒体 框架 (MediaFrameword) : 这 部 分 内 容 是 Android 多 媒体 的 核心 部 分 ， 基 于 PacketVideo 
(HIPV) 的 OpenCORE， 从 功能 上 本 库 一 共 分 为 两 大 部 分 ， 一 个 部 分 是 音频 、 视 频 的 回放 
(PlayBack) ， 另 一 部 分 则 是 音 视频 的 记录 (Recorder) 。 
口 SGL: 2D 图 像 引擎 。 
口 SSL: 即 Secure Socket Layer 位 于 TCP/IP 协 议 与 各 种 应 用 层 协议 之 间 , 为 数据 通信 提供 安全 支持 。 
口 OpenGL ES 1.0: 提供 对 3D 的 支持 。 
О 界面 管理 工具 (Surface Management) : 提供 了 对 管理 显示 子 系统 等 功能 。 
口 
口 
口 


SQLite: 一 个 通用 的 嵌入 式 数据 库 。 
WebKit: 网 络 浏览 器 的 核心 。 
FreeType: 位 图 和 矢量 字体 的 功能 。 
Android 的 各 种 库 一 般 是 以 系统 中 间 件 的 形式 提供 的 , 它们 均 有 的 一 个 显著 特点 就 是 与 移动 设备 的 
平台 应 用 密切 相关 。 
Android 运行 环境 主要 是 指 的 虚拟 机 技术 一 一 Dalvik。Dalvik 虚拟 机 和 一 般 Java 虚拟 机 (Java VM) 
不 同 ， 它 执行 的 不 是 Java 标准 的 字 节 码 (Bytecode )， 而 是 Dalvik 可 执行 格式 (dex) 中 执行 文件 。 在 
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执行 的 过 程 中 ， 每 一 个 应 用 程序 即 一 个 进程 (Linux 的 一 个 Process)。 二 者 最 大 的 区 别 在 于 Java VM 是 
基于 栈 的 虚拟 机 (Stack-based)， 而 Dalvik 是 基于 寄存 器 的 虚拟 机 (Register-based)。 显 然 ， 后 者 最 大 
的 好 处 在 于 可 以 根据 硬件 实现 更 大 的 优化 ， 这 更 适合 移动 设备 的 特点 。 


4.1.3 应 用 程序 CApplication) 


Android 的 应 用 程序 主要 是 用 户 界面 (User Interface) 方面 的 ， 通 常用 Java 语言 编写 ， 其 中 还 可 以 
包含 各 种 资源 文件 (放置 在 res ARP). Java 程序 和 相关 资源 在 经 过 编译 后 ， 会 生成 一 个 APK 包 。 
Android 本 身 提供 了 主屏 幕 (Home), IRA (Contact), if (Phone) 和 浏览 器 (Browser) 等 众多 
的 核心 应 用 。 同 时 应 用 程序 的 开发 者 还 可 以 使 用 应 用 程序 框架 层 的 АРІ 实现 自己 的 程序 ， 这 也 是 
Android 开源 的 巨大 潜力 的 体现 。 


414 应 用 程序 框架 (Application Framework) 


Android 的 应 用 程序 框架 为 应 用 程序 层 的 开发 者 提供 APIS， 它 实际 上 是 一 个 应 用 程序 的 框架 。 由 
于 上 层 的 应 用 程序 是 以 Java 构建 的 ， 因 此 本 层次 提供 的 首先 包含 了 UI 程序 中 所 需要 的 各 种 控件 ， 例 
如 Views (视图 组 件 )， 其 中 又 包括 了 List AIR), Grid СИНЕ). Text Вох (文本 框 ) 和 Button (按钮 ) 
等 ， 甚 至 一 个 嵌入 式 的 Web 浏览 器 。 

作为 一 个 基本 的 Android 应 用 程序 ， 可 以 利用 应 用 程序 框架 中 的 以 下 5 个 部 分 来 构建 。 

Q Activity (活动 ) 。 

Q Broadcast Intent Receiver (广播 意 图 接收 者 ) 。 

O Service (12) 。 

Q Content Provider (内 容 提供 者 ) 。 

口 Intent and Intent Filter (意图 和 意图 过 滤器 ) 。 


42 Ў Android 应 用 工程 文件 
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讲解 完 Android 的 整体 结构 之 后 , 接 下 来 开始 讲解 Android 工 ow sirs 
8-08 sre 


程 文件 的 组 成 。 顶 层 的 Android 应 用 程序 通常 使 用 Eclipse+Java $8 firsta 
组 合 来 实现 , 在 Eclipse 工程 中 , 一 个 基本 的 Android 项 目的 目录 eo ша 


结构 如 图 4-2 所 示 。 
在 本 节 的 内 容 中 ,将 详细 讲解 Android 应 用 程序 工程 文件 中 各 27 
个 组 成 部 分 的 具体 信息 。 BG rotle 


SÈ layout 
a 


4.2.1 src 程序 目录 ы 
同 Androi dani fest. xml 
В project. properties 


图 4-2 Android 应 用 工程 文件 组 成 


sre 程序 目录 下 保存 了 开发 人 员 编写 的 程序 文件 。 和 一 般 的 
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Java 项 目 一 样 ，src 目录 下 保存 的 是 项 目的 所 有 包 及 源 文件 (java)， 包 含 了 项 目 中 的 所 有 资源 ， 例 如 ， 
程序 图 标 (drawable) 、 布 局 文件 Clayout) 和 常量 (values) 等 。 不 同 的 是 ， 在 Java 项 目 中 没有 gen 
目录 ， 也 没有 每 个 Android 项 目 都 必须 有 的 AndroidManfest.xml 文件 。 
java 格式 文件 是 在 建立 项 目 时 自动 生成 的 ， 这 个 文件 是 只 读 模式 ， 不 能 更 改 。Rjava 文件 是 定义 
该 项 目 所 有 资源 的 索引 文件 。 例 如 下 面 是 某 项 目 中 R.java 文件 的 代码 。 
package com.yarin.Android.HelloAndroid; 
public final class R { 
public static final class attr { 
} 


public static final class drawable { 
public static final int icon=0x7f020000; 


} 

public static final class layout { 
public static final int main=0x7f030000; 

} 

public static final class string { 
public static final int арр пате=0х7#040001; 
public static final int һео=0х7#040000; 

} 


} 

在 上 述 代码 中 定义 了 很 多 常量 ， 并 且 这 些 常 量 的 名 字 都 与 res 文件 夹 中 的 文件 名 相同 ， 这 再 次 证 
明 java 文件 中 所 存储 的 是 该 项 目 所 有 资源 的 索引 。 有 了 这 个 文件 , 在 程序 中 使 用 资源 将 变 得 更 加 方便 ， 
可 以 很 快 地 找到 要 使 用 的 资源 ， 由 于 这 个 文件 不 能 手动 编辑 ,所 以 当 我 们 在 项 目 中 加 入 了 新 的 资源 时 ， 
只 需要 刷新 一 下 该 项 目 ，.java 文件 便 自 动 生成 了 所 有 资源 的 索引 。 


4.2.2 设置 文件 AndroidManfest.xml 


文件 AndroidManfestxml 是 一 个 控制 文件 , 里 面包 含 了 该 项 目 中 所 使 用 的 Activity. Service 和 Receiver. 
例如 下 面 是 某 项 目 中 文件 AndroidManfestxml 的 代码 。 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmins:android="http://schemas.android.com/apk/res/android" 
package-"com.yarin.Android.HelloAndroid" 
android:versionCode="1" 
android:versionName="1.0"> 
«application android:icon="@drawable/icon" 
android:label="@string/app_name"> 
«activity android:name-".HelloAndroid" 
android:label="@string/app_name"> 
<intent-filter> 
«action android:name="android.intent.action. MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
<uses-sdk android:minSdkVersion="9" /> 
</manifest> 


在 上 述 代码 中 ,intent-filters 描述 了 Activity 启动 的 位 置 和 时 间 。 每 当 一 个 Activity (或 者 操作 系统 ) 
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要 执行 一 个 操作 时 ， 它 将 创建 出 一 个 Intent 的 对 象 ， 这 个 Intent 对 象 可 以 描述 你 想 做 什么 ， 你 想 处 理 什 
么 数据 ， 数 据 的 类 型 ， 以 及 一 些 其 他 信息 。Android 会 和 每 个 Application 所 暴露 的 intent-filter 的 数据 
进行 比较 ， 找 到 最 合适 Activity 来 处 理 调用 者 所 指定 的 数据 和 操作 。 下 面 我 们 来 仔细 分 析 
AndroidManfest.xml 文件 ， 如 表 4-1 所 示 。 
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manifest 


表 4-1 AndroidManfest.xml 分 析 
d а 
根 节点 ， 描 述 了 package 中 所 有 的 内 容 


xmlns:android 


包含 命名 空间 的 声明 。xmilns:android=http://schemas.android.com/apk/res/android， 使 得 Android 中 
各 种 标准 属性 能 在 文件 中 使 用 ， 提 供 了 大 部 分 元 素 中 的 数据 


package 声明 应 用 程序 包 
包含 package 中 application 级 别 组 件 声明 的 根 节点 。 此 元 素 也 可 包含 application 的 一 些 全 局 和 默 

application 认 的 属性 ， 如 标签 、icon、 主 题 、 必 要 的 权限 等 。 一 个 manifest 能 包含 零 个 或 一 个 此 元 素 ( 不 能 
AT?) 

android:icon 应 用 程序 图 标 

android:label | 应 用 程序 名 字 
activity 是 与 用 户 交互 的 主要 工具 ， 是 用 户 打开 一 个 应 用 程序 的 初始 页 面 ， 大 部 分 被 使 用 到 的 其 他 
页 面 也 由 不 同 的 activity 所 实现 ， 并 声明 在 另外 的 activity 标记 中 。 注意 ， 每 一 个 activity 必须 有 一 

activity 个 <activity> 标 记 对 应 ,无 论 它 给 外 部 使 用 或 是 只 用 于 自己 的 package 中 。 如 果 一 个 activity 没有 对 
应 的 标记 , 你 将 不 能 运行 它 。 另外 , 为 了 支持 运行 时 查找 activity, 可 包含 一 个 或 多 个 <intent-filter> 
元 素来 描述 activity 所 支持 的 操作 

android:name | 应 用 程序 默认 启动 的 activit 

声明 了 指定 的 一 组 组 件 支持 的 Intent 值 ， 从 而 形成 Intent Filter。 除 了 能 在 此 元 素 下 指定 不 同类 型 

bntent-filter | 的 值 ， 属 性 也 能 放 在 这 里 来 描述 一 个 操作 所 需 的 唯一 的 标签 、icon 和 其 他 信息 

action 组 件 支持 的 Intent action 

catego 组 件 支持 的 Intent Category。 这 里 指定 了 应 用 程序 默认 启动 的 activity 

uses-sdk 该 应 用 程序 所 使 用 的 sdk 版 本 相关 


423 ”常量 定义 文件 


下 面 我 们 看 看 在 资源 文件 中 对 常量 的 定义 ， 例 如 文件 String.xml 的 代码 如 下 所 示 。 


<?xml version="1.0" encoding="utf-8"?> 


<resources> 


<string name="hello">Hello World, HelloAndroid!</string> 
<string name="app_name">HelloAndroid</string> 


</resources> 


上 述 常量 定义 文件 的 代码 非常 简单 ， 只 定义 了 两 个 字符 串 资源 ， 请 不 要 小 看 上 面 的 几 行 代码 。 它 
们 的 内 容 很 “露脸 ”， 里 面 的 字符 直接 显示 在 手机 屏幕 中 ， 就 像 动态 网 站 中 的 HTML 一 样 。 


4.2.4 Ul 布局 文件 


布局 (layout) 文件 一 般 位 于 res\layout\main.xml 目录 ， 通 过 其 代码 能 够 生成 一 个 显示 界面 。 例 如 


下 面 的 代码 。 
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<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="fill_ parent" 
android:layout_height="fill_ parent" 
> 


<TextView 
android:layout_width="fill_ parent" 
android:layout_height="wrap_content" 
android:text="@string/hello" 
> 

</LinearLayout> 

在 上 述 代码 中 ， 有 以 下 几 个 布局 和 参数 。 

口 <LinearLayout></LinearLayout>: 在 这 个 标签 中 ， 所 有 元 件 都 是 按 由 上 到 下 排 成 的 。 

口 android:orientation: 表示 这 个 介质 的 版 面 配置 方式 是 从 上 到 下 垂直 地 排列 其 内 部 的 视图 。 

口 android:layout_ width: 定义 当前 视图 在 屏幕 上 所 占 的 宽度 ，fill_parent 即 填充 整个 屏幕 。 

O android:layout_height: 定义 当前 视图 在 屏幕 上 所 占 的 高 度 ，fill_parent 即 填充 整个 屏幕 。 

O wrap content: 随 着 文字 栏 位 的 不 同 而 改变 这 个 视图 的 宽度 或 高 度 。 

在 上 述 布 局 代码 中 ， 使 用 了 一 个 TextView 来 配置 文本 标签 Widget 构件)， 其 中 设置 的 属性 
android:layout_width 为 整个 屏幕 的 宽度 , android:layout_height 可 以 根据 文字 来 改变 高 度 , 而 android:text 
则 设置 了 这 个 TextView 要 显示 的 文字 内 容 ， 这 里 引用 了 @string 中 的 hello 字符 串 ， 即 String.xml 文件 
中 的 hello 所 代表 的 字符 串 资源 。hello 字符 串 的 内 容 "Hello World，HelloAndroid!" 这 就 是 我 们 在 
HelloAndroid 项 目 运 行 时 看 到 的 字符 串 。 


注意 : 上 面 介绍 的 文件 只 是 主要 文件 ， 在 项 目 中 需要 我 们 自行 编写 。 在 项 目 中 还 有 很 多 其 他 的 文件 ， 
那些 文件 很 少 需 要 我 们 编写 ， 所 以 在 此 就 不 进行 讲解 了 。 


4.3 5 大 核心 组 件 


GEM 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 4 章 \5 大 核心 组 件 .avi 
一 个 典型 的 Android 应 用 程序 通常 由 5 个 组 件 组 成 , 这 5 个 组 件 实现 了 Android 应 用 程序 的 核心 功 
能 。 本 节 将 一 一 讲解 这 5 大 组 件 的 基本 知识 ， 为 学 习 本 书后 面 的 知识 打下 基础 。 


4.3.1 Activity 界面 组 件 


Activities 是 这 5 个 组 件 中 最 常用 的 一 个 组 件 。 程 序 中 Activity 通常 的 表现 形式 是 一 个 单独 的 界面 
(screen)。 每 个 Activity 都 是 一 个 单独 的 类 , 它 扩展 实现 了 Activity 基础 类 。 这 个 类 显示 为 一 个 由 Views 
组 成 的 用 户 界面 ， 并 响应 事件 。 大 多 数 程序 有 多 个 Activity. 例如, 一 个 文本 信息 程序 有 这 么 几 个 界面 : 
显示 联系 人 列表 界面 、 写 信息 界面 、 查 看 信息 界面 或 者 设置 界面 等 。 每 个 界面 都 是 一 个 Activity， 切 换 
到 另 一 个 界面 就 是 载 入 一 个 新 的 Activity。 某 些 情况 下 ， 一 个 Activity 可 能 会 给 前 一 个 Activity 返回 值 一 一 
如 一 个 让 用 户 选择 相片 的 Activity 会 把 选择 到 的 相片 返回 给 其 调用 者 。 
® 
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前 面 已 经 打开 的 存放 在 历史 栈 中 的 界面 ， 也 可 以 从 历史 栈 中 删除 没有 界面 价值 的 界面 。Android 在 历史 
栈 中 保留 程序 运行 产生 的 所 有 界面 : 从 第 一 个 界面 ， 到 最 后 一 个 。 


4.3.2 Intent 切换 组 件 


Android 通过 一 个 专门 的 Intent 类 来 进行 界面 的 切换 。Intent 描述 了 程序 想 做 什么 (Intent 意 为 意图 、 
目的 、 意 向 )。Intent 类 还 有 一 个 相关 类 IntentFilter。Intent 是 一 个 请 求 来 做 什么 事情 ，IntentFilter 则 描 
述 了 一 个 Activity (或 下 文 的 mtentReceiver) 能 处 理 什么 意图 。 显 示 某 人 联系 信息 的 Activity 使 用 了 一 个 
IntentFilter, 就 是 说 它 知道 如 何 处 理应 用 到 此 人 数据 的 VIEW 操作 。Activities 在 文件 AndroidManifestxml 
中 使 用 IntentFilters。 

通过 解析 Intents 可 以 实现 Activity 的 切换 , 我 们 可 以 使 用 startActivity(myIntent) 启 用 新 的 Activity 。 
系统 会 考察 所 有 安装 程序 的 IntentFilters， 然 后 找到 与 myIntent 匹配 最 好 的 IntentFilters 所 对 应 的 
Activity。 这 个 新 Activity 能 够 接收 Intent 传 来 的 消息 ， 并 因此 被 启用 。 解 析 Intents 的 过 程 发 生 在 
startActivity 被 实时 调用 时 ， 这 样 做 有 如 下 两 个 好 处 。 

(1) Activities 仅 发 出 一 个 Intent 请 求 ， 便 能 重用 其 他 组 件 的 功能 。 
(2) Activities 可 以 随时 被 蔡 换 为 有 等 价 IntentFilter 的 新 Activity. 


4.3.8 Service 服务 组 件 


Service 是 一 个 没有 UI 且 长 驻 系统 的 代码 ， 最 常见 的 例子 是 媒体 播放 器 从 播放 列表 中 播放 歌曲 。 
在 媒体 播放 器 程序 中 ， 可 能 有 一 个 或 多 个 Activity 让 用 户 选 择 播放 的 歌曲 。 然 而 在 后 台 播放 歌曲 时 无 
须 Activity 干涉 , 因为 用 户 希望 在 音乐 播放 的 同时 能 够 切换 到 其 他 界面 。 既 然 这 样 , 媒体 播放 器 Activity 
需要 通过 Context.startService() 启 动 一 个 Service， 这 个 Service 在 后 台 运 行 以 保持 继续 播放 音乐 。 在 媒 
体 播放 器 被 关闭 之 前 ， 系 统 会 保持 音乐 后 台 播 放 Service 的 正常 运行 。 可 以 用 Context.bindService() 方 法 
连接 到 一 个 Service 上 (如 果 Service 未 运行 的 话 ， 连 接 后 还 会 启动 它 )， 连 接 后 就 可 以 通过 一 个 Service 
提供 的 接口 与 Service 进行 通话 。 对 音乐 Service 来 说 ， 提 供 了 和 暂停 和 重 放 等 功能 。 


1. 如 何 使 用 服务 


在 Android 系统 中 有 如 下 两 种 使 用 服务 的 方法 。 
CD 通过 调用 Context.startService() 启 动 服务 ， 调 用 Context.stopService() 结 束 服务 ，startService() 
可 以 传递 参数 给 Service。 
(2) 通过 调用 Context.bindService() /5 2), WH Context.unbindService() 结 束 ， 还 可 以 通过 
ServiceConnection 访问 Service。 二 者 可 以 混合 使 用 ， 比 如 说 可 以 先 startService() 再 unbindService()。 


2. Service 的 生命 周期 


在 startService() 后 ， 即 使 调用 startService0 的 进程 结束 了 ，Service 还 仍然 存在 ,一 直到 有 进程 调用 
stopService() 或 者 Service 自己 灭亡 (stopSelf()) Auk. 

1E bindService() 后 ，Service 就 和 调用 bindService() 的 进程 同 生 共 死 ， 也 就 是 说 当 调 用 bindService() 
的 进程 死 了 ， 那 么 它 绑 定 的 Service 也 要 跟着 被 结束 ， 当 然 期 间 也 可 以 调用 unbindService() 让 Service 
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结束 。 
当 混 合 使 用 上 述 两 种 方式 时 , 例如 你 startService() f , 我 bindService0 了 ，, 那么 只 有 你 stopService() 
而 且 我 也 unbindService() 了 ， 这 个 Service 才 会 被 结束 。 


3. 进程 生命 周期 


Android 系统 将 会 尝试 保留 那些 启动 了 的 或 者 绑 定 了 的 服务 进程 ， 具 体 说 明 如 下 所 示 。 

(1) 如 果 该 服务 正在 进程 的 onCreate()、onStart() 或 者 onDestroy(0) 这 些 方 法 中 执行 ， 那么 主 进程 将 
会 成 为 一 个 前 台 进 程 ， 以 确保 此 代码 不 会 被 停止 。 

QD 如 果 服 务 已 经 开始 ， 那 么 它 的 主 进程 的 重要 性 会 低 于 所 有 的 可 见 进程 ， 但 是 会 高 于 不 可 见 进 
程 。 由 于 只 有 少数 几 个 进程 是 用 户 可 见 的 ， 所 以 只 要 不 是 内 存 特 别 低 ， 该 服务 就 不 会 停止 。 

(3) 如 果 有 多 个 客户 端 绑 定 了 服务 ， 只 要 客户 端 中 的 一 个 对 于 用 户 是 可 见 的， 就 可 以 认为 该 服务 可 见 。 


4.3.4  Broadcast/Receiver 广播 机 制 组 件 


当 要 执行 一 些 与 外 部 事件 相关 的 代码 时 ， 比 如 来 电 响 铃 时 或 者 半夜 时 就 可 能 用 到 IntentReceiver。 尽 
管 IntentReceiver 使 用 NotificationManager 来 通知 用 户 一 些 好 玩 的 事情 发 生 , 但 是 没有 UI. IntentReceiver 
可 以 在 文件 AndroidManifest.xml 中 声明 ， 也 可 以 使 用 ContextregisterReceiver() 来 声明 。 当 一 个 
IntentReceiver 被 触发 时 , 如 果 需 要 , 系统 自然 会 自动 启动 程序 。 程 序 也 可 以 通过 Context.broadcastIntent() 
来 发 送 自 己 的 Intent 广播 给 其 他 程序 。 


4.3.5 ContentProvider 存储 组 件 


应 用 程序 把 数据 存放 在 一 个 SQLite 数据 库 格式 文件 里 ， 或 者 存放 在 其 他 有 效 设 备 里 。 如 果 想 让 其 
他 程序 能 够 使 用 我 们 程序 中 的 数据 ， 此 时 ContentProvider 就 很 有 用 了 。ContentProvider 是 一 个 实现 了 
一 系列 标准 方法 的 类 ， 这 个 类 使 得 其 他 程序 能 存储 、 读 取 某 种 ContentProvider 可 处 理 的 数据 。 


44 进程 和 线程 


и 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 4 章 \ 进 程 和 线程 .avi 

进程 和 线程 很 容易 理解 ， 在 PC 机 的 Windows 系统 中 都 有 一 个 进程 管理 器 ， 当 打开 后 ， 会 显示 当 
前 运行 的 所 有 程序 。 同 样 在 Android 系统 中 也 有 进程 ， 当 某 个 组 件 第 一 次 运行 的 时 候 ，Android 会 启动 
一 个 进程 。 在 默认 情况 下 ， 所 有 的 组 件 和 程序 运行 在 这 个 进程 和 线程 中 ， 也 可 以 安排 组 件 在 其 他 的 进 
程 或 者 线程 中 运行 。 本 节 将 详细 讲解 Android 系统 中 进程 和 线程 的 基本 知识 。 


4.4.1 应 用 程序 的 生命 周期 


自然 界 的 事物 都 有 自己 的 生命 周期 ， 例 如 和 的 生 、 老 、 病 、 死 。 作 为 一 个 Android 应 用 程序 也 如 
同 自然 界 的 生物 一 样 ， 有 自己 的 生命 周期 。 我 们 开发 一 个 程序 的 目的 是 为 了 完成 一 个 功能 ， 例 如 银行 
计算 加 息 的 软件 ， 每 当 一 个 用 户 去 柜台 办 理 取 款 业 务 时 ， 银 行 工作 人 员 便 启动 了 我 们 这 个 程序 的 生命 ， 
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oid 外 设 开发 实战 


当 用 这 个 软件 完成 利息 计算 时 ， 这 个 软件 当前 的 任务 就 完成 了 ， 此 时 就 需要 结束 自己 的 使 命 。 肯 定 有 
人 提出 疑问 : 生生 死 死 多 么 麻烦 ， 就 让 这 个 程序 一 直 是 “活着 ”的 状态 ， 一 个 用 户 办 理 完 取款 业务 后 ， 
继续 等 着 下 一 个 用 户 办 理 取款 业务 ， 这 样 这 个 程序 就 “长 生 不 老 ” 了 。 其 实 谁 都 想 自己 的 程序 “长 生 
不 老 ”， 但 是 很 不 幸 ， 我 们 不 能 这 样 做 。 原 因 是 计算 机 的 处 理性 能 是 一 定 的 ， 一 个 人 、 两 个 人 、 三 个 人 
计算 机 可 以 处 理 这 个 任务 ,但 是 一 个 安装 这 个 软件 的 机 器 一 天 会 处 理 上 千 上 万 个 取款 业务 ， 如 果 它 们 
都 一 直 活 着 ， 一 台 有 限 配置 的 计算 机 能 承受 得 了 吗 ? 

由 此 可 见 ， 应 用 程序 的 生命 周期 就 是 一 个 程序 的 存活 时 间 ， 即 在 什么 时 间 内 有 效 。Android 是 一 个 
构建 在 Linux 之 上 的 开源 移动 开发 平台 ， 在 Android 中 ， 多 数 情 况 下 每 个 程序 都 是 在 各 自 独立 的 Linux 
进程 中 运行 的 。 当 一 个 程序 或 其 某 些 部 分 被 请 求 时 ， 它 的 进程 就 “出 生 ” 了 ; 当 这 个 程序 没有 必要 再 
运行 下 去 且 系 统 需要 回收 这 个 进程 的 内 存 用 于 其 他 程序 时 , 这 个 进程 就 “死亡 ”了 。 可 以 看 出 , Android 
程序 的 生命 周期 是 由 系统 控制 而 非 程序 自身 直接 控制 。 这 和 我 们 编写 桌面 应 用 程序 时 的 思维 有 一 些 不 
同 ， 一 个 桌面 应 用 程序 的 进程 也 是 在 其 他 进程 或 用 户 请 求 时 被 创建 ， 但 是 往往 是 在 程序 自身 收 到 关闭 
请 求 后 执行 一 个 特定 的 动作 〈 比 如 从 main() 函 数 中 返回 ) 而 导致 进程 结束 的 。 要 想 做 好 某 种 类 型 的 程 
序 或 者 某 种 平台 下 的 程序 的 开发 ， 最 关键 的 就 是 要 和 弄 清楚 这 种 类 型 的 程序 或 整个 平台 下 的 程序 的 一 般 
工作 模式 并 熟 记 在 心 。 在 Android 中 ， 程 序 的 生命 周期 控制 就 是 属于 这 个 范畴 。 

开发 者 必须 理解 不 同 的 应 用 程序 组 件 ， 尤 其 是 Activity. Service 和 Intent Receiver， 需 要 了 解 这 些 
组 件 是 如 何 影响 应 用 程序 生命 周期 的 。 如 果 不 正确 地 使 用 这 些 组 件 ， 可 能 会 导致 系统 终止 正在 执行 重 
要 任务 的 应 用 程序 进程 。 

一 个 常见 的 进程 生命 周期 漏洞 的 例子 是 Intent Receiver (意图 接收 器 )， 当 Intent Receiver 在 
onReceive() 方 法 中 接收 到 一 个 Intent (意图 ) 时 ， 它 会 启动 一 个 线程 ， 然 后 返回 。 一 旦 返回 ， 系 统 将 认 
X Intent Receiver 不 再 处 于 活动 状态 ， 因 而 Intent Receiver 所 在 的 进程 也 就 不 再 有 用 了 除非 该 进程 中 
还 有 其 他 的 组 件 处 于 活动 状态 )。 因 此 ， 系 统 可 能 会 在 任意 时 刻 终止 该 进程 以 回收 占有 的 内 存 。 这 样 进程 
中 创建 出 的 那个 线程 也 将 被 终止 。 解决 这 个 问题 的 方法 是 从 Intent Receiver 中 启动 一 个 服务 , 让 系统 知道 
进程 中 还 有 处 于 活动 状态 的 工作 。 为 了 使 系统 能 够 正确 决定 在 内 存 不 足 时 应 该 终止 哪个 进程 , Android He 
据 每 个 进程 中 运行 的 组 件 及 组 件 的 状态 把 进程 放 入 一 个 Importance Hierarchy (重要 性 分 级 ) 中 。 
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组 件 运行 的 进程 是 由 manifest file 控制 的 。 组 件 的 节点 一 般 都 包含 一 个 process 属性 ,例如 <activity>、 
<service>、<receiver> 和 <provider> 节 点 。 属 性 process 可 以 设置 组 件 运行 的 进程 ， 可 以 配置 组 件 在 一 个 
独立 进程 中 运行 ， 或 者 多 个 组 件 在 同一 个 进程 中 运行 ， 甚 至 可 以 多 个 程序 在 一 个 进程 中 运行 ， 当 然 前 
提 是 这 些 程序 共享 一 个 User ID 并 给 定 同样 的 权限 。 另 外 <application> 节 点 也 包含 了 process 属性 , 用 来 
设置 程序 中 所 有 组 件 的 默认 进程 。 

当 更 加 常用 的 进程 无 法 获取 足够 内 存 时 ，Android 会 智能 地 关闭 不 常用 的 进程 ， 当 下 次 启动 程序 时 
会 重新 启动 这 些 进程 。 当 决定 哪个 进程 需要 被 关闭 的 时 候 ，Android 会 考虑 哪个 对 用 户 更 加 有 用 。 例 如 
Android 会 倾向 于 关闭 一 个 长 期 不 显示 在 界面 的 进程 来 支持 一 个 经 常 显示 在 界面 的 进程 。 是 否 关 闭 一 个 
进程 决定 于 组 件 在 进程 中 的 状态 。 

进程 的 类 型 多 种 多 样 ， 按 照 重要 的 程度 主要 包括 如 下 几 类 进程 。 
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(1) 前 台 进 程 (Foreground) 

前 台 进 程 是 看 得 见 的 ， 与 用 户 当前 正在 做 的 事情 密切 相关 ， 不 同 的 应 用 程序 组 件 能 够 通过 不 同 的 
方法 将 它 的 宿主 进程 移 到 前 台 。 在 如 下 的 任何 一 个 条 件 下 系统 会 把 进程 移动 到 前 台 。 

О 进程 正在 屏幕 的 最 前 端 运行 一 个 与 用 户 交互 的 活动 (Activity) ， 它 的 onResume() 方 法 被 调用 。 

O 进程 有 一 个 正在 运行 的 Intent Receiver ( 它 的 IntentReceiver.onReceive 方 法 正在 执行 ) 。 

口 进程 有 一 个 服务 (Service) ， 并 且 在 服务 的 某 个 回调 函数 (Service.onCreate、Service.onStart 或 

Service.onDestroy) 内 有 正在 执行 的 代码 。 

(2) 可 见 进程 (Visible) 

可 见 进程 也 是 可 见 的 ， 它 有 一 个 可 以 被 用 户 从 屏幕 上 看 到 的 活动 ， 但 不 在 前 台 它 的 onPause() 方 
法 被 调用 )。 假 如 前 台 的 活动 是 一 个 对 话 框 ， 以 前 的 活动 隐藏 在 对 话 框 之 后 就 会 出 现 这 种 进程 。 可 见 进 
程 非常 重要 ， 一 般 不 允许 被 终止 ， 除 非 是 为 了 保证 前 台 进程 的 运行 而 不 得 不 终止 它 。 

(3) 服务 进程 (Service) 

服务 进程 是 无 法 看 见 的 , 拥有 一 个 已 经 用 startService() 方 法 启动 的 服务 。 虽 然 用户 无 法 直接 看 到 这 
些 进程 ， 但 它们 做 的 事情 却 是 用 户 所 关心 的 (如 后 台 MP3 回放 或 后 台 网 络 数据 的 上 传 下 载 )。 所 以 系 
统 将 一 直 运 行 这 些 进程 ， 除 非 内 存 不 足以 维持 所 有 的 前 台 进 程 和 可 见 进程 。 

(4) 后 台 进 程 (Background) 

后 台 进 程 也 是 看 不 见 的 ， 只 有 打开 之 后 才能 看 见 。 例 如 迅雷 下 载 ， 我 们 可 以 将 其 最 小 化 ， 虽 然 在 
桌面 上 看 不 见 了 ， 但 是 它 一 直 在 进行 下 载 的 工作 ， 拥 
有 一 个 当前 用 户 看 不 到 的 活动 ( 它 的 onStop() 方 法 被 调 Жынды 
用 )。 这 些 进 程 对 用 户 体验 没有 直接 的 影响 。 如 果 它 们 EE 
正确 执行 了 活动 生命 周期 ， 系 统 可 以 在 任意 时 刻 终止 WE 
该 进程 以 回收 内 存 ， 并 提供 给 前 面 3 种 类 型 的 进程 使 《| jitactivity 
用 。 系 统 中 通常 有 很 多 这 样 的 进程 在 运行 ， 因 此 要 将 | 
这 些 进程 保存 在 LRU 列表 中 , 以 确保 当 内 存 不 足 时 用 | 结束 进程 
户 最 近 看 到 的 进程 最 后 一 个 被 终止。 

(5) 空 进程 (Empty) 

空 进程 是 指 不 拥有 任何 活动 的 应 用 程序 组 件 的 进 
组 件 需 要 运行 时 ， 不 需要 重新 创建 进程 ， 这 样 可 以 提高 | ЖЕНЕ 
启动 速度 。 系 统 将 以 进程 中 当前 处 于 活动 状态 组 件 的 重 | 另 一 个 活动 来 到 前 台 
要 程度 为 基础 对 进程 进行 分 类 。 进 程 的 优先 级 可 能 也 会 
根据 该 进程 与 其 他 进程 的 依赖 关系 而 增长 。 假 如 进程 A 
通过 在 进程 B 中 设置 Context.BIND_AUTO_CREATE 标 
记 或 使 用 ContentProvider 被 绑 定 到 一 个 服务 (Service), 


onRestan() 


另 一 个 活动 来 到 前 台 


在 前 台 运 行 


onPausef) 


那么 进程 B 在 分 类 时 至 少 要 被 看 成 与 进程 A 同 等 重要 。 лау 
例如 Activity 的 状态 转换 图 如 图 4-3 所 示 。 
图 4-3 所 示 的 状态 的 变化 是 由 Android 内 存 管理 器 图 43 Activity 状态 转换 图 


决定 的 ，Android 会 首先 关闭 那些 包含 Inactive Activity 的 应 用 程序 ， 然 后 关闭 Stopped 状态 的 程序 。 只 
有 在 极端 情况 下 才 会 移 除 Paused 状态 的 程序 。 
K) 
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当 用 户 界面 需要 很 快 对 用 户 进行 响应 时 ， 就 需要 将 一 些 费 时 的 操作 ， 如 网 络 连接 、 下 载 或 者 非常 
占用 服务 器 时 间 的 操作 等 放 到 其 他 线程 。 也 就 是 说 ， 即 使 为 组 件 分 配 了 不 同 的 进程 ， 有 时 也 需要 再 分 
配 线程 。 

线程 是 通过 Java 的 标准 对 象 Thread 来 创建 的 ， 在 Android 中 提供 了 如 下 方便 的 管理 线程 的 方法 。 


a 


DODDOD 


D 


Looper 在 线程 中 运行 一 个 消息 循环 。 

Handler 传递 一 个 消息 。 

HandlerThread 创 建 一 个 带 有 消息 循环 的 线程 。 

Android 让 一 个 应 用 程序 在 单独 的 线程 中 ， 指 导 它 创建 自己 的 线程 。 

应 用 程序 组 件 (Activity、Service、Broadcast/Receiver) 所 有 都 在 理想 的 主线 程 中 实例 化 。 

没有 一 个 组 件 应 该 执行 长 时 间或 是 阻塞 操作 例如 网 络 呼叫 或 是 计算 循环 ) ， 当 被 系统 调用 时 ， 
这 将 中 断 所 有 在 该 进程 的 其 他 组 件 。 

可 以 创建 一 个 新 的 线程 来 执行 长 期 操作 。 


4.5 Android 和 Linux 的 关系 


ЁШ 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 4 章 \Android 和 Linux 的 关系 .avi 


虽 


然 Android 系统 采用 Linux 作为 其 内 核 ， 但 是 谷歌 对 Linux 内 核 做 了 修改 ， 以 适应 其 在 Android 


移动 设备 上 的 应 用 。Android 开始 是 作为 Linux 的 一 个 分 支 ， 后 来 由 于 无 法 并 入 Linux 的 主 开发 树 ， 曾 
经 被 Linux 内 核 组 从 开发 树 中 删除 。 直 到 2012 年 5 月 18 Н, Linux Kernel 3.3 发 布 后 又 被 加 入 到 Linux 
的 主 开发 树 中 。 本 节 将 详细 讲解 Android 系统 和 Linux 系统 之 间 的 关系 。 


4.5.1 


Android 继承 于 Linux 


Android 是 在 Linux 的 内 核 基础 之 上 运行 的 , 提供 的 核心 系统 服务 包括 安全 、 内 存 管理 、 进 程 管理 、 
网 络 组 和 驱动 模型 等 内 容 。 内 核 部 分 还 相当 于 一 个 介 于 硬件 层 和 系统 中 其 他 软件 组 之 间 的 一 个 抽象 层 
次 。 但 是 严格 来 说 它 不 算是 Linux 操作 系统 。 


因 


为 Android 内 核 是 由 标准 的 Linux 内 核 修改 而 来 的 ， 所 以 继承 了 Linux 内 核 的 诸多 优点 , 保留 了 


Linux 内 核 的 主题 架构 。 同 时 Android 按照 移动 设备 的 需求 ， 在 文件 系统 、 内 存 管理 、 进 程 间 通信 机 制 
和 电源 管理 方面 进行 了 修改 ， 添 加 了 相关 的 驱动 程序 和 必要 的 新 功能 。 但 是 和 其 他 精简 的 Linux 系统 


相 比 《 
更 强 。 


(e 
Ooocodoo 


比如 uClinux)，Android 很 大 程度 地 保留 了 Linux 的 基本 架构 ， 因 此 Android 的 应 用 性 和 扩展 性 
当前 Android 版 本 对 应 的 Linux 内 核 版 本 如 下 。 

Android 1.5: Linux-2.6.27. 

Android 1.6: Linux-2.6.29. 

Android 2.0,2.1: Linux-2.6.29. 

Android 2.2: Linux-2.6.32.9. 

Android 4.3: Linux-3.4. 
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4.5.2 Android #1 Linux 内 核 的 区 别 


Android 系统 的 系统 层面 的 底层 是 Linux, 中 间 加 上 了 一 个 叫做 Dalvik 的 Java 虚拟 机 , 表面 层 上 面 
是 Android 运行 库 。 每 个 Android 应 用 都 运行 在 自己 的 进程 上 ， 享 有 Dalvik 虚拟 机 为 它 分 配 的 专 有 实 
例 。 为 了 支持 多 个 虚拟 机 在 同一 个 设备 上 高 效 运行 ，Dalvik 被 改写 过 。 

Dalvik 虚拟 机 执行 的 是 Dalvik 格式 的 可 执行 文件 〈.dex) 一 一 该 格式 经 过 优化 ， 以 降低 内 存 耗 用 
到 最 低 。Java 编译 器 将 Java 源 文件 转 为 class 文件 , class 文件 又 被 内 置 的 dx 工具 转化 为 dex 格式 文件 ， 
这 种 文件 在 Dalvik 虚拟 机 上 注册 并 运行 。 

Android 系统 的 应 用 软件 都 是 运行 在 Dalvik 之 上 的 Java 软件 ， 而 Dalvik 是 运行 在 Linux 中 的 ， 在 
一 些 底层 功能 一 一 比如 线程 和 低 内 存 管理 方面 ，Dalvik 虚拟 机 是 依赖 Linux 内 核 的 。 由 此 可 见 ， 可 以 
说 Android 是 运行 在 Linux 之 上 的 操作 系统 ， 但 是 它 本 身 不 能 算是 Linux 的 某 个 版 本 。 

Android 内 核 和 Linux 内 核 的 差别 主要 体现 在 11 个 方面 ， 接 下 来 将 一 一 简要 介绍 。 

(1) Android Binder 

其 源 代码 位 于 : 

drivers/staging/android/binder.c 

Android Binder 是 基于 OpenBinder 框架 的 一 个 驱动 ， 用 于 提供 Android 平台 的 进程 间 通 信 

(Inter-Process Communication, IPC)。 原 来 的 Linux 系统 上 层 应 用 的 进程 间 通 信 主 要 是 D-bus (Desktop 
Bus)， 采 用 消息 总 线 的 方式 来 进行 IPC. 
(2) Android 电源 管理 (PM) 

Android 电源 管理 是 一 个 基于 标准 Linux 电源 管理 系统 的 轻 量 级 的 Android На BIKA), АПК 
入 式 设备 做 了 很 多 优化 。 利 用 锁 和 定时 器 来 切换 系统 状态 ， 控 制 设备 在 不 同 状态 下 的 功 耗 ， 以 达到 节 
能 的 目的 。 

Android 电源 管理 的 源 代码 分 别 位 于 : 

kemel/power/earlysuspend.c 

kernel/power/consoleearlysuspend.c 

kernel/power/fbearlysuspend.c 


kernel/power/wakelock.c 
kernel/power/userwakelock.c 


(3) 低 内 存 管理 器 (Low Memory Killer) 

Android 中 的 低 内 存 管理 器 和 Linux 标准 的 OOM (Out Of Memory) 相 比 ， 其 机 制 更 加 灵活 ， 它 可 
以 根据 需要 杀 死 进程 来 释放 需要 的 内 存 。 低 内 存 管 理 器 的 代码 很 简单 ， 关 键 的 一 个 函数 是 
Lowmem_shrinker。 作 为 一 个 模块 在 初始 化 时 调用 register_shrinker 注册 了 一 个 Lowmem_shrinker, 它 会 
被 VM 在 内 存 紧张 的 情况 下 调用 。Lowmem_shrinker 完成 具体 操作 。 简 单 说 就 是 寻找 一 个 最 合适 的 进 
程 杀 死 ， 从 而 释放 它 占 用 的 内 存 。 

低 内 存 管理 器 的 源 代码 位 于 : drivers/staging/android/lowmemorykiller.c. 

(4) 匿名 共享 内 存 (Ashmem) 

匿名 共享 内 存 为 进程 间 提供 大 块 共享 内 存 ， 同 时 为 内 核 提供 回收 和 管理 这 个 内 存 的 机 制 。 如 果 一 个 
程序 尝试 访问 Keme 释放 的 一 个 共享 内 存 块 , 它 将 会 收 到 一 个 错误 提示 , 然后 重新 分 配 内 存 并 重 载 数据 。 

匿名 共享 内 存 的 源 代码 位 于 : mm/ashmem.c。 
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(5) Android PMEM (Physical ) 
PMEM 用 于 向 用 户 空间 提供 连续 的 物理 内 存 区 域 ,DSP 和 某 些 设备 只 能 工作 在 连续 的 物理 内 存 上 。 
驱动 中 提供 了 mmap. open. release 和 ioctl 等 接口 。 
Android PMEM 的 源 代码 位 于 : drivers/misc/pmem.c. 
(6) Android Logger 
Android Logger 是 一 个 轻 量 级 的 日 志 设 备 , 用 于 抓 取 Android 系统 的 各 种 日 志 , 是 Linux 所 没有 的 。 
其 源 代码 位 于 : drivers/staging/android/logger.c。 
(7) Android Alarm 
Android Alarm 提供 了 一 个 定时 器 用 于 把 设备 从 睡眠 状态 唤醒 ， 同 时 它 也 提供 了 一 个 即使 在 设备 睡 
眠 时 也 会 运行 的 时 钟 基准 。 
Android Alarm 的 源 代码 位 于 : 
О drivers/rtc/alarm.c 
O drivers/rtc/alarm-dev.c 
(8) USB Gadget 驱动 
USB Gadget 驱动 是 一 个 基于 标准 Linux USB Gadget 驱动 框架 的 设备 驱动 , Android 的 USB 驱动 是 
基于 Gadget 框架 的 。 
USB Gadget 驱动 的 源 代 码 位 于 : 
О drivers/usb/gadget/android.c 
口 drivers/usb/gadget/f adb.c 
口 drivers/usb/gadget/f mass storage.c 
(9) Android Ram Console 
为 了 提供 调试 功能 ，Android 允许 将 调试 日 志 信息 写 入 一 个 被 称 为 RAM Console 的 设备 里 ， 它 是 
一 个 基于 RAM 的 Buffer. 
Android Ram Console 的 源 代码 位 于 : drivers/staging/android/ram console.c. 
(10) Android timed device 
Android timed device 提供 了 对 设备 进行 定时 控制 功能 ， 目 前 仅仅 支持 vibrator 和 LED 设备 。 其 源 
代码 位 于 : drivers/staging/android/timed_output.c(timed_gpio.c)。 
(11) Yaffs2 文件 系统 
在 Android 系统 中 ， 采 用 Yaffs2 作为 MTD NAND Flash 文件 系统 。Yaffs2 是 一 个 快速 稳定 的 应 用 
T NAND 和 NOR Flash 的 跨 平台 的 嵌入 式 设备 文件 系统 ， 同 其 他 Flash 文件 系统 相 比 ，Yaffs2 使 用 更 
小 的 内 存 来 保存 它 的 运行 状态 ， 因 此 它 占 用 内 存 小 ，Yaffs2 的 垃圾 回收 非常 简单 而 且 快速 ， 因 此 能 达 
到 更 好 的 性 能 ，Yaffs2 在 大 容量 的 NAND Flash 上 性 能 表现 尤为 明显 ， 非 常 适合 大 容量 的 Flash 存储 。 
Yaffs2 文件 系统 源 代码 位 于 fs/yaffs2/ 目 录 下 。 
Android 是 在 Linux 的 内 核 基 础 之 上 运行 的 , 提供 的 核心 系统 服务 包括 安全 、 内 存 管理 、 进 程 管理 、 
网 络 组 和 驱动 模型 等 内 容 。 内 核 部 分 还 相当 于 一 个 介 于 硬件 层 和 系统 中 其 他 软件 组 之 间 的 一 个 抽象 层 
次 。 但 是 严格 来 说 它 不 算是 Linux 操作 系统 。 
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4.6 编写 第 一 段 Android 程序 


ШЫ 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 4 章 \ 编 写 第 一 段 Android 程序 .avi 

经 过 本 书 前 面 内 容 的 学 习 ， 已 经 了 解 Android 系统 诞生 和 具体 架构 知识 ， 也 了 解 了 搭建 Android 
开发 环境 的 方法 。 在 本 节 的 内 容 中 , 将 创建 一 个 Android 应 用 程序 项 目 ， 演 示 开 发 Android 应 用 程序 的 
具体 流程 。 本 实例 的 功能 是 在 手机 屏幕 中 显示 问候 语 “你 好 我 的 朋友 !”， 在 具体 开始 之 前 先 做 一 个 简 
单 的 流程 规划 ， 如 图 4-4 所 示 。 


Java 代 码 | — |Debug 调 斌 


| | 


用 Eclipse | 新 建 工程 一 ;| 编写 代码 [一 | 调试 项 目 | —5 运行 项 目 


断 点 调试 


4-4 规划 流程 图 


实例 功能 源码 路 径 
实例 4-1 演示 第 一 个 Android 应 用 程序 光盘 :\daimav4first 


4.6.1 新 建 一 个 Android 工程 


1. 新 建 工程 


(1) 在 Eclipse 中 依次 选择 File | New | Project 命令 新 建 一 个 工程 文件 ， 如 图 4-$ 所 示 。 
(2) 选择 Android Project 选项 ， 单 击 Next 按钮 。 
(3) 在 弹出 的 New Android Project 对 话 框 中 设置 工程 信息 ， 如 图 4-6 所 示 。 

在 图 4-6 所 示 的 界面 中 依次 设置 工程 名 字 、 包 名 字 、Activity 名 字 和 应 用 名 字 。 


2. 编写 代码 和 代码 分 析 


现在 已 经 创建 了 一 个 名 为 first 的 工程 文件 ， 打 开 文件 frstjava， 会 显示 自动 生成 的 如 下 代码 。 
package first.a; 
import android.app.Activity; 
import android.os.Bundle; 
public class fistMM extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.main); 
} 
} 
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图 4-5 新 建 工程 文件 图 4-6 设置 工程 


如 果 此 时 运行 程序 ， 将 不 会 显示 任何 内 容 。 此 时 我 们 可 以 对 上 述 代码 进行 修改 ， 让 程序 输出 “你 


好 我 的 朋友 !”。 具体 代码 如 下 所 示 。 
package first.a; 
import android.app.Activity; 
import android.os.Bundle; 
import android.widget.TextView; 


public class fistMM extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.main); 
TextView tv = new TextView(this); 
tv.setText(" 你 好 我 的 朋友 ! "); 
setContentView(tv); 
} 
} 
经 过 上 述 代码 改写 后 ， 应 该 可 以 在 屏幕 中 输出 “你 好 我 的 朋友 !”， 完 全 符合 预期 的 要 求 。 


4.6.2 ”调试 程序 


Android 调试 一 般 分 为 3 个 步 又， 分 别 是 设置 断 点 、Debug 调试 和 断 点 调试 。 
(1) 设置 断 点 
此 处 的 设置 断 点 和 Java 中 的 方法 一 样 ， 可 以 通过 双击 代码 左边 的 区 域 进行 断 点 设置 ， 如 图 4-7 所 示 。 


@ 
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为 了 调试 方便 ， 可 以 设置 显示 代码 的 行 数 。 只 需 在 代码 左 侧 的 空白 部 分 右键 单 击 ， 在 弹出 的 快捷 
菜单 中 选择 Show Line Numbers， 如 图 4-8 所 示 。 
(2) Debug 调试 
Debug Android 调试 项 目的 方法 和 普通 Debug Java 调试 项 目的 方法 类 似 , 唯一 的 不 同 是 在 调试 项 目 
时 选择 Android Application 命令 。 具 体 方法 是 右键 单 击 项 目 名 ， 在 弹出 的 快捷 菜单 中 选择 Debug As | 
Android pone 命令 ， 如 图 4-9 所 示 。 


1 package first. а; 


2@import android.app.Activity;[] 
5 
ү 6 public class first extends Activity ( 
7 /** Called when the activity is first created. */ 
808 _ Goverride 
public void onCreate (Bundle savedInstancestete) ( 
super. onCreate (savedInstancestate); 
setContentView(R.layout.main); 
TextView tv = new Ree tidal) 
су. secTexc ("你 好 我 的 朋 ; 


setContentView (tv) ; 


图 4-7 设置 断 点 


mort androig.app.Activity;|| 


irat extends Activity ( 
when the activity is first created. */ 


d onCreate (Bundle savedInstanceState] ( 
lev tv = new TextViev(this); 


Text "你 好 我 的 朋友 ! "); 


itentViev(tv); 


201 - first] Starting activity first.a.first 


图 4-8 显示 行 数 图 4.9 Debug MH 


(3) 断 点 调试 
可 以 进行 单 步调 试 ， 具 体 调试 方法 和 调试 普通 Java 程序 的 方法 类 似 ， 调 试 界面 如 图 4-10 所 示 。 


@ 


озен 


6 public class fistME extends Activity ( 
7| /** Called when the sctivity is first created. */ 
8 override 
public void onCreate (Bundle savedInstanceState) | 
super .onCceaze (savedInstancestate) : 


[2009-12-14 14:32:18 — first] ERROI 

[2009-12-14 14:32:21 - first] -- 

[2009-12-14 14:32:21 - first] Android Leunch! 

[2009-12-14 14:32:21 - first]ado is running normally. 
[2009-12-14 14:22:21 - first] ERROR: Application does not з 


图 4-10 调试 界面 


463 ”运行 程序 


将 上 述 代码 保存 后 就 可 运行 这 段 程 序 了 ， 具 体 过 程 如 下 。 


(1) 右键 单 击 项 目 名 , 在 弹出 的 快捷 菜单 中 依次 选择 Run As | Android Application 命令 , 如 图 4-11 
所 示 。 


ager .Texcview: 


аети extends activity ( 
when the activity is zirst created. */ 


oncreate(Suncie savedinstancestate| ( 
oncreate (savedinstancestate) ; 
prentvieu(, 1aycut meinl + 

tv = new Textvieu(tnt 
Text |"HeLLoWor ie"): 
prentvaeu(cv): 
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(2) 此 时 工程 开始 运行 ， 运 行 完成 后 在 屏幕 中 输出 “你 好 我 的 朋友 !” 这 段 文 字 ， 如 图 4-12 所 示 。 


тоја а ер вао 
о Ги le lr lr v [u |: fo fe] 
Арен B 
ткт == 


412 运行 结果 


这 样 ， 我 们 的 Android 应 用 程序 便 创建 并 调试 运行 完毕 了 。 由 此 可 见 ， 通 过 Eclipse 工具 可 以 高 效 
地 开发 出 我 们 需要 的 Android 应 用 程序 。 
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传感器 是 近年 来 随 着 物 联网 这 一 概念 的 流行 而 推出 的 ， 现 在 人 们 已 经 逐渐 地 了 解 了 传感器 这 一 概 
念 。 其 实 传感器 在 大 家 的 日 常生 活 中 经 常见 到 甚至 是 用 到 ， 比 如 楼 宇 的 声控 楼 梯 灯 和 马路 上 的 路 灯 等 。 
EFR Android 外 设 项 目 程序 时 ,经 常 通过 传感器 来 建立 Android 软件 系统 和 外 部 硬件 设备 之 间 的 纽带 。 
本 章 将 详细 讲解 Android 系统 中 传感器 系统 的 基本 架构 知识 ， 为 读者 学 习 本 书后 面 的 知识 打下 基础 。 


51 Android 传感器 系统 概述 


ШМ 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 5 章 \Android 传感器 系统 概述 .avi 

在 Android 系统 中 提供 的 主要 传感器 有 : 加 速度 传感器 、 磁 场 、 方 向 、 陀 螺 仪 、 光 线 、 压 力 、 温 
度 和 接近 等 。 传 感 器 系统 会 主动 对 上 层 报 告 传感器 精度 和 数据 的 变化 ， 并 且 提 供 了 设置 传感器 精度 的 
接口 ， 这 些 接口 可 以 在 Java 应 用 和 Java 框架 中 使 用 。 

Android 传感器 系统 的 基本 层次 结构 如 图 5-1 所 示 。 


Android 应 用 


y 


本 地 框架 屏幕 方向 管理 
Sensor 的 Java 类 
Android 系 统 
本 地 框架 
Sensor JNI 和 硬件 抽象 层 
хӯ 
加 速度 、 磁 场 、 温 度 等 传感器 设备 硬件 和 驱动 


5-1 传感器 系统 的 层次 结构 


根据 图 5-1 所 示 的 结构 ，Android 传感器 系统 从 上 到 下 分 别 是 : Java 应 用 层 、Java 框架 对 传感器 的 
应 用 、 传 感 器 类 、 传 感 器 硬件 抽象 层 、 传 感 器 驱动 。 图 5-1 中 各 个 层 的 具体 说 明 如 下 。 
(1) 传感器 系统 的 Java 部 分 


其 代码 路 径 是 : 
frameworks/base/include/core/java/android/hardware 


此 部 分 对 应 的 实现 文件 是 Sensor* java. 
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(2) 传感器 系统 的 JNI 部 分 
其 代码 路 径 是 : 
frameworks/base/core/jni/android_hardware_SensorManager.cpp 
在 此 部 分 中 提供 了 对 类 android hardware.Sensor. Manage 的 本 地 支持 。 
(3) 传感器 系统 HAL 层 
头 文件 路 径 是 : 
hardware/libhardware/include/hardware/sensors.h 
在 Android 系统 中 ， 传 感 器 系统 的 硬件 抽象 层 需要 特意 编码 实现 。 
(4) 驱动 层 
驱动 层 的 代码 路 径 是 : 
kemel/driver/hwmon/$(PROJECT)/sensor 
TERE sensor.so 中 提供 了 如 下 8 个 API 函数 。 
O 控制 方面 : 在 结构 体 ensors_control device t 中 定义 ， 包 括 如 下 函数 。 
+ int(*open_ data source)(struct sensors control device t *dev) 
+  int(*activate)(struct sensors control device t *dev, int handle, int enabled) 
*  int(*set delay)(struct sensors control device t *dev, int32 t ms) 
+  int(*wake)(struct sensors control device t *dev) 
О 数据 方面 : 在 结构 体 sensors_data_device_t 中 定义 ， 包 括 如 下 函数 。 
+  int(*data open)(struct sensors data device t *dev, int fd) 
*  int(*data close)(struct sensors data device t *dev) 
+ int (*poll)(struct sensors data device t *dev, sensors data t* data) 
Q 模块 方面 : 在 结构 体 sensors_module t 中 定义 ， 包 括 如 下 函数 。 
*  int(*get sensors list)(struct sensors module t* module, struct sensor t const** list) 
在 Android 系统 的 Java EP, Sensor 的 状态 是 由 SensorService 来 负责 控制 的 ， 其 Java 代码 和 JNI 


代码 分 别 位 于 如 下 文件 中 。 
frameworks/base/services/java/com/android/server/SensorService.java 
frameworks/base/services/jni/com_android_server_SensorService.cpp 


SensorManager 负责 在 Java 层 Sensor 的 数据 控制 , 它 的 Java 代码 和 INI 代码 分 别 位 于 如 下 文件 中 。 
frameworks/base/core/java/android/hardware/SensorManager.java 
frameworks/base/core/jni/android_hardware_SensorManager.cpp 


在 Android 的 Framework "P, 通过 文件 sensorService.java 和 sensorManager.java 实现 与 Sensor 传 感 
器 通信 。 文 件 sensorServicejava 的 通信 功能 是 通过 JNI 调用 sensorService.cpp 中 的 方法 实现 的 。 

文件 sensorManagerjava 的 具体 通信 功能 是 通过 INI 调用 sensorManager.cpp 中 的 方法 实现 的 。 文 件 
sensorService.cpp 和 sensorManager.cpp 通过 文件 hardware.c 与 sensor.so 通信 。 其 中 文件 sensorService.cpp 
实现 对 sensor 的 状态 控制 , 文件 sensorMangercpp 实 现 对 sensor 的 数据 控制 。 库 sensorso 通 过 ioctl 控 制 sensor 
driver 的 状态 ， 通 过 打开 Sensor Driver (传感器 驱动 ) 对 应 的 设备 文件 读 取 G-sensor 采集 的 数据 。 

在 本 节 的 内 容 中 ， 将 简要 讲解 Android 传感器 系统 中 各 个 层次 的 架构 知识 。 


5.11 传感器 系统 的 层 详解 


在 Android 系统 中 ， 传 感 器 系统 的 Java 部 分 的 实现 文件 是 : 


x) 


Android 外 设 开发 实战 


\sdk\apps\SdkController\src\com\android\tools\sdkcontroller\activities\SensorActivity.java 
通过 阅读 文件 SensorActivity.java 的 源码 可 知 , 在 应 用 程序 中 使 用 传感器 需要 用 到 hardware 包 中 的 
SensorManager、SensorListener 等 相关 的 类 ， 具 体 实现 代码 如 下 所 示 。 


public class SensorActivity extends BaseBindingActivity 
implements android.os.Handler.Callback { 


@SuppressWamings("hiding") 
public static String TAG = SensorActivity.class.getSimpleName(); 
private static boolean DEBUG = true; 


private static final int MSG UPDATE ACTUAL HZ = 0x31415; 


private TableLayout mTableLayout; 
private TextView mTextError; 

private TextView mTextStatus; 

private TextView mTextTargetHz; 

private TextView mTextActualHz; 

private SensorChannel mSensorHandler; 


private final Map<MonitoredSensor, DisplayInfo» mDisplayedSensors = 
new HashMap<SensorChannel.MonitoredSensor, SensorActivity.DisplayInfo>(); 
private final android.os. Handler mUiHandler = new android.os.Handler(this); 
private int mTargetSampleRate; 
private long mLastActualUpdateMs; 


Р* 第 一 次 创建 activity 时 调用 */ 

@Override 

public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.sensors); 
mTableLayout = (TableLayout) findViewByld(R.id.tableLayout); 
mTextError = (TextView) findViewByld(R.id.textError); 
mTextStatus = (TextView) findViewByld(R.id.textStatus); 
mTextTargetHz = (TextView) findViewByld(R.id.textSampleRate); 
mTextActualHz = (TextView) findViewByld(R.id.textActualRate); 
updateStatus("Waiting for connection"); 


mTextTargetHz.setOnKeyListener(new OnKeyListener() { 
@Override 
public boolean onKey(View v, int keyCode, KeyEvent event) { 
updateSampleRate(); 
return false; 
} 
ys 
mTextTargetHz.setOnFocusChangeListener(new OnFocusChangeListener() f 
@Override 
public void onFocusChange(View v, boolean hasFocus) { 
updateSampleRate(); 
} 
ys 
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} 


@Override 

protected void onResume() { 
if (DEBUG) Log.d(TAG, "onResume"); 
II BaseBindingActivity 绑 定 后 套 服务 


super.onResume(); 
updateError(); 

} 

@Override 


protected void onPause() { 
if (DEBUG) Log.d(TAG, "onPause"); 


super.onPause(); 

} 

@Override 

protected void onDestroy() { 
if (DEBUG) Log.d(TAG, "onDestroy"); 
super.onDestroy(); 
removeSensorUi(); 

} 

// 创 建 传感器 UI 


private void createSensorUi() { 
final LayoutInflater inflater = getLayoutinflater(); 


if (ImDisplayedSensors.isEmpty()) { 
removeSensorUi(); 


} 


mSensorHandler = (SensorChannel) getServiceBinder().getChannel(Channel.SENSOR_CHANNEL); 
if (mSensorHandler != null) { 
mSensorHandler.addUiHandler(mUiHandler); 
mUiHandler.sendEmptyMessage(MSG_UPDATE_ACTUAL_HZ); 


assert mDisplayedSensors.isEmpty(); 
List<MonitoredSensor> sensors = mSensorHandler.getSensors(); 
for (MonitoredSensor sensor : sensors) { 
final TableRow row = (TableRow) inflater.inflate(R.layout.sensor row, 


mTableLayout, 
false); 

mTableLayout.addView(row); 

mDisplayedSensors.put(sensor, new DisplayInfo(sensor, row)); 

) 
} 
} 
/删除 传感器 U! 


private void removeSensorUi() { 
if (mSensorHandler != null) ( 
mSensorHandler.removeUiHandler(mUiHandler); 
mSensorHandler - null; 
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} 
mTableLayout.removeAllViews(); 
for (Displaylnfo info : mDisplayedSensors.values()) { 
info.release(); 
} 
mDisplayedSensors.clear(); 
} 


private class Displaylnfo implements CompoundButton.OnCheckedChangeListener { 
private MonitoredSensor mSensor; 
private CheckBox mChk; 
private TextView mVal; 


public DisplayInfo(MonitoredSensor sensor, TableRow row) ( 
mSensor - sensor; 


II Initialize displayed checkbox for this sensor, and register 
11 checked state listener for it 

mChk = (CheckBox) row.findViewByld(R.id.row checkbox); 
mChk.setText(sensor.getUiName()); 
mChk.setEnabled(sensor.isEnabledByEmulator()); 
mChk.setChecked(sensor.isEnabledByUser()); 
mChk.setOnCheckedChangeListener(this); 


// 初 始 化 显示 该 传感器 的 文本 框 
mVal = (TextView) row.findViewByld(R.id.row_textview); 
mVal.setText(sensor.getValue()); 


} 


p 
* 为 相关 的 复 选 框 选中 状态 进行 变化 的 处 理 。 当 复 选 框 被 选中 时 会 注册 传感器 变化 
* 如 果 不 加 以 控制 会 取消 传感器 的 变化 
+) 
@Override 
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { 
if (mSensor != null) { 
mSensor.onCheckedChanged(isChecked); 


} 

} 

public void release() { 
mChk = null; 
mVal = null; 


mSensor - null; 


} 


public void updateState() { 
if (mChk != null && mSensor != null) { 
mChk.setEnabled(mSensor.isEnabledByEmulator()); 
mChk.setChecked(mSensor.isEnabledByUser()); 


e 


第 5 章 Android 传感器 系统 架构 详解 


} 


public void updateValue() { 
if (mVal != null && mSensor != null) { 
mVal.setText(mSensor.getValue()); 


) 
} 


人 ”实现 回调 处 理 程序 */ 
@Override 
public boolean handleMessage(Message msg) { 
Displaylnfo info = null; 
Switch (msg.what) ( 
case SensorChannel.SENSOR STATE CHANGED: 
info = mDisplayedSensors.get(msg.obj); 
if (info != null) { 
info.updateState(); 
} 
break; 
case SensorChannel.SENSOR DISPLAY MODIFIED: 
info = mDisplayedSensors.get(msg.obj); 
if (info != null) { 
info.updateValue(); 
} 
if (mSensorHandler != null) { 
updateStatus(Integer.toString(mSensorHandler.getMsgSentCount()) + " events sent"); 


// 如 果 值 已 经 修改 则 更 新 "actual rate" 
long ms = mSensorHandler.getActualUpdateMs(); 
if (ms != mLastActualUpdateMs) { 
mLastActualUpdateMs = ms; 
String hz = mLastActualUpdateMs <= 0 ? "--" : 
Integer.toString((int) Math.ceil(1000. / ms)); 
mTextActualHz.setText(hz); 
} 
} 
break; 
case MSG_UPDATE_ACTUAL_HZ: 
if (mSensorHandler != null) { 
// 如 果 值 已 经 修改 则 更 新 "actual rate" 
long ms = mSensorHandler.getActualUpdateMs(); 
if (ms != mLastActualUpdateMs) { 
mLastActualUpdateMs = ms; 
String hz = mLastActualUpdateMs <= 0 ? "--" : 
Integer.toString((int) Math.ceil(1000. / ms)); 
mTextActualHz.setText(hz); 
) 
mUiHandler.sendEmptyMessageDelayed(MSG UPDATE ACTUAL HZ, 1000 /*15*/); 
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} 
return true; // we consumed this message 
} 
private void updateSampleRate() { 
String str = mTextTargetHz.getText().toString(); 
try { 
int hz = Integer.parselnt(str.trim()); 
// 上 限 值 50， 模 拟 器 的 最 大 值 是 50 赫兹 
if (hz <= 0 || hz > 50) { 
hz = 50; 
} 
if (hz != mTargetSampleRate) { 
mTargetSampleRate = hz; 
if (mSensorHandler != null) { 
mSensorHandler.setUpdateTargetMs(hz «- 0 ? 0 : (int)(1000.0f / hz)); 
) 
} 
} catch (Exception ignore) { } 
} 


} 
通过 上 述 代码 可 知 ， 整 个 Java 层 利用 观察 者 模式 对 传感器 的 数据 进行 了 监听 处 理 。 


5.1.2 Frameworks 层 详 解 


在 Android 系统 中 ，Frameworks 层 是 Android 系统 提供 的 应 用 程序 开发 接口 和 应 用 程序 框架 ， 与 
应 用 程序 的 调用 是 通过 类 实例 化 或 类 继承 进行 的 。 对 应 用 程序 来 说 ， 最 重要 的 就 是 把 SensorListener 注 
册 到 SensorManager 上 ， 从 而 才能 以 观察 者 身份 接收 到 数据 的 变化 ， 因 此 ， 我 们 把 目光 落 在 
SensorManager 的 构造 函数 、RegisterListener 函数 和 通知 机 制 相关 的 代码 上 。 在 Android 传感器 系统 中 ， 
Frameworks 层 的 代码 路 径 是 frameworks/base/include/core/java/android/hardware。 在 本 节 的 内 容 中 ， 将 
详细 讲解 传感器 系统 的 Frameworks 层 的 具体 实现 流程 。 


1. 监听 传感器 的 变化 


在 Android 传感器 系统 的 Frameworks 层 中 ， 文 件 SensorListenerjava 用 于 监听 从 Java 应 用 层 中 传 


递 过 来 的 变化 。 文 件 SensorListenerjava 比较 简单 ， 具 体 代码 如 下 所 示 。 
package android.hardware; 
@Deprecated 
public interface SensorListener { 
public void onSensorChanged(int sensor, float[] values); 
public void onAccuracyChanged(int sensor, int accuracy); 
) 


2. 注册 监听 


当 文 件 SensorListenerjava 监听 到 变化 之 后 , 会 通过 文件 SensorManagerjava 向 服务 注册 监听 变化 ， 
调度 Sensor 的 具体 任务 。 例 如 在 开发 Android 传感器 应 用 程序 时 ， 在 上 层 的 通用 开发 流程 如 下 。 


e 


СТ) 通过 “getSystemService(SENSOR_SERVICE);” 语 句 得 到 传感器 服务 。 这 样 得 到 一 个 用 来 管 
理 分 配 调度 处 理 Sensor 工作 的 SensorManager。SensorManager 并 不 服务 运行 于 后 台 ， 真 正 属于 Sensor 
的 系统 服务 是 SensorService, 在 终端 下 的 #service list 中 可 以 看 到 sensorservice: [android.gui. SensorServer] 。 

(2) 通过 “getDefaultSensor(Sensor.TYPE_GRAVITY);” 得 到 传感器 类 型 ， 当 然 还 有 各 种 千奇百怪 
的 传感器 ， 具 体 可 以 查阅 Android 官网 的 АРІ 或 者 源码 中 的 文件 Sensorjava。 

(3) 注册 监听 器 SensorEventListener。 在 应 用 程序 中 打开 一 个 监听 接口 ， 专 门 用 于 处 理 传感器 的 
数据 。 

(4) 通过 回调 函数 onSensorChanged 和 onAccuracyChanged 实现 实时 监听 。 例 如 对 重力 感应 器 的 
xyz 值 经 算法 变换 得 到 左右 上 下 前 后 方向 等 ， 就 由 这 个 回调 函数 实现 。 

综 上 所 述 ， 传 感 器 顶层 的 处 理 流程 如 图 5-2 所 示 。 


/frameworks/base 
/core/java/android 
/hardware/Sensor! 
anager java. 


52 传感器 顶层 的 处 理 流程 


文件 SensorManagerjava 的 具体 实现 流程 如 下 。 
(1) 定义 类 SensorManager， 然 后 设置 各 种 传感器 的 初始 变量 值 ， 具 体 代码 如 下 所 示 。 
public abstract class SensorManager { 
protected static final String TAG = "SensorManager"; 
private static final float[ ] mTempMatrix = new float[16]; 


11 Cached lists of sensors by type. Guarded by mSensorListByType 
private final SparseArray<List<Sensor>> mSensorListByType = 
new SparseArray<List<Sensor>>(); 


11 Legacy sensor manager implementation. Guarded by mSensorListByType during initialization 
private LegacySensorManager mLegacySensorManager; 

@Deprecated 

public static final int SENSOR_ORIENTATION = 1 << 0; 

@Deprecated 

public static final int SENSOR_ACCELEROMETER = 1 << 1; 


am) 
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@Deprecated 

public static final int SENSOR_TEMPERATURE = 1 << 2; 
@Deprecated 

public static final int SENSOR_MAGNETIC_FIELD = 1 << 3; 
@Deprecated 

public static final int SENSOR_LIGHT = 1 << 4; 

@Deprecated 

public static final int SENSOR_PROXIMITY = 1 << 5; 
@Deprecated 

public static final int SENSOR_TRICORDER = 1 << 6; 
@Deprecated 

public static final int SENSOR ORIENTATION RAW = 1 << 7; 
@Deprecated 

public static final int SENSOR_ALL = 0x7F; 

@Deprecated 

public static final int SENSOR MIN = SENSOR ORIENTATION; 
@Deprecated 

public static final int SENSOR_MAX = ((SENSOR_ALL + 1)>>1); 


@Deprecated 

public static final int DATA_X = 0; 
@Deprecated 

public static final int DATA_Y = 1; 
@Deprecated 

public static final int DATA Z = 2; 
@Deprecated 

public static final int RAW_DATA_INDEX = 3; 
@Deprecated 

public static final int RAW_DATA_X = 3; 
@Deprecated 

public static final int RAW_DATA_Y = 4; 
@Deprecated 

public static final int RAW DATA Z = 5; 


public static final float STANDARD_GRAVITY = 9.80665f; 


public static final float GRAVITY_SUN = 275.06; 

public static final float GRAVITY_MERCURY = 3.706 

public static final float GRAVITY_VENUS = 8.876, 

public static final float GRAVITY_EARTH = 9.80665f; 
public static final float GRAVITY_MOON = 1.6f; 

public static final float GRAVITY_MARS = 3.716 

public static final float GRAVITY_JUPITER = 23.12f; 

public static final float GRAVITY_SATURN = 8.96f; 

public static final float GRAVITY_URANUS = 8.69f; 

public static final float GRAVITY NEPTUNE = 11.06 

public static final float GRAVITY_PLUTO = 0.6f; 

public static final float GRAVITY DEATH STAR | = 0.000000353036145f; 
public static final float GRAVITY THE ISLAND = 4.815162342f; 
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妨 对 地 球 表 面 的 最 大 磁场 "/ 

public static final float MAGNETIC FIELD EARTH MAX = 60.0f; 

Tp ERE B A 

public static final float MAGNETIC FIELD EARTH MIN - 30.0f; 

I^ 标准 大 气压 */ 

public static final float PRESSURE STANDARD ATMOSPHERE = 1013.25f; 
public static final float LIGHT SUNLIGHT MAX - 120000.0f; 


public static final float LIGHT SUNLIGHT = 110000.0f; 
public static final float LIGHT SHADE = 20000.0f; 
public static final float LIGHT OVERCAST = 10000.0f; 
public static final float LIGHT SUNRISE = 400.0f; 
public static final float LIGHT CLOUDY = 100.0f; 
public static final float LIGHT FULLMOON = 0.25; 
public static final float LIGHT NO MOON = 0.001f; 
/* 尽 可 能 快 地 获得 传感器 数据 */ 

public static final int SENSOR DELAY FASTEST = 0; 

/* 适 合 游戏 速度 */ 

public static final int SENSOR_DELAY_GAME = 1; 

/* 适 合 于 用 户 接口 速率 */ 


public static final int SENSOR_DELAY_UI = 2; 

/* GME) 适合 屏幕 方向 的 变化 */ 

gua static final int SENSOR DELAY NORMAL = 3; 

p 该 传感器 是 不 可 信 的 ， 需 要 进行 校准 或 环境 不 允许 读数 
sible static final int SENSOR_STATUS_UNRELIABLE = 0; 

“该 人 器 是 报告 的 人 精度 的 数据 与 环境 的 校准 是 必要 的 

ure static final int SENSOR STATUS ACCURACY LOW = 1; 

т невина THREE RUE, 与 环境 的 校准 可 以 提高 精确 度 
ЫР static final int SENSOR_STATUS_ACCURACY_MEDIUM = 2; 


Ir fe AR SEER AW SCE) 

public static final int SENSOR_STATUS_ACCURACY_HIGH = 3; 
public static final int AXIS_X = 1; 

public static final int AXIS_Y = 2; 

public static final int AXIS Z = 3; 

public static final int AXIS_MINUS_X = AXIS_X | 0x80; 

public static final int AXIS_MINUS_Y = AXIS_Y | 0x80; 

public static final int AXIS_MINUS_Z = AXIS Z | 0x80; 


(2) 定义 各 种 设备 类 型 和 设备 数据 的 方法 ， 这 些 方法 非常 重要 ， 在 编写 的 应 用 程序 中 ， 可 以 通过 
AIDL 接口 远程 调用 (RPC) 的 方式 得 到 SensorManager。 这 样 通过 在 类 SensorManager 中 的 方法 ， 可 
以 得 到 底层 的 各 种 传感器 数据 。 上 述 方法 的 具体 实现 代码 如 下 所 示 。 

@ 


М яа 


public int getSensors() { 
retum getLegacySensorManager().getSensors(); 


) 
public List<Sensor> getSensorList(int type) ( 
/人 第 一 次 缓存 返回 列表 
List<Sensor> list; 
final List<Sensor> fullList = getFullSensorList(); 
synchronized (mSensorListByType) { 
list = mSensorListByType.get(type); 
if (list == null) { 
if (type == Sensor. TYPE ALL) { 
list = fullList; 
) else { 
list = new ArrayList<Sensor>(); 
for (Sensor i : fullList) { 
if (i getType() == type) 
list.add(i); 
) 
} 
list = Collections.unmodifiableList(list); 
mSensorListByType.append(type, list); 
} 
} 
return list; 
} 


上 述 方法 的 功能 非常 重要 ， 其 实 就 是 我 们 在 开发 传感器 应 用 程序 时 用 到 的 API 接口 。 有 关上 述 方 
法 的 县 体 说 明 , 读者 可 以 查阅 官网 SDK АРІ 中 对 于 类 android.hardware.SensorManager 的 具体 说 明 ， 如 
图 5-3 所 示 。 


App Components TYPE_ACCELEROMETER Hardware Measures the acceleration force inm/s2that Motion 
is applied to a device on all three physical detection 
App Resources е axes (x, y, and z), including the force of (shake, tilt, 
gravity. etc.). 
App Manifest M TYPE AMBIENT TEMPERATURE ^ Hardware Measures the ambient room temperature in Monitoring air 
degrees Celsius (*C). See note below. temperatures. 
User Interface 
TYPE_GRAVITY Software ^ Measures the force of gravity in m/s?thatis ^ Motion 
Animation and Graphics. v or applied to a device on all three physical axes detection 
Hardware (х, у, 2). (shake, tilt, 
Computation v etc) 
Media and Camera TYPE_GYROSCOPE Hardware Measures a device's rate of rotation in rad/s Rotation 
around each of the three physical axes (x, y, detection 
Location and Sensors Y апат). (spin, turn, 
etc.) 
Connectivity TYPE LIGHT Hardware ^ Measures the ambient light level Controlling 
(illumination) in lx. Screen 
Text and Input Brightness 
Data Storage v TYPE_LINEAR_ACCELERATION Software Measures the acceleration force in m/s2 that Monitoring 
ог is applied to a device on all three physical acceleration 
Administration v Hardware axes (x у, and г), excluding the force of along a single 


Е 5-3 Android SDK АРІ 中 对 android.hardware.SensorManager 的 具体 说 明 


e 


лыс 
5.1.3 ШМБ ЕЁ 


在 Android 系统 中 ， 传 感 器 系统 的 JNI 部 分 的 代码 路 径 是 : 
frameworks/base/core/jni/android_hardware_SensorManager.cpp 
在 此 文件 中 提供 了 对 类 android.hardware.Sensor.Manager 的 本 地 支持 。 上 层 和 JNI 层 的 调用 关系 如 


5-4 所 示 。 


5-4 上 层 和 JNI 层 的 调用 关系 


在 图 5-4 所 示 的 调用 关系 中 涉及 了 如 下 的 API 接口 方法 。 

O nativeClasslnit(): 在 JNI 层 得 到 android.hardware.Sensor 的 JNI 环 境 指针 。 

O sensors module init(): 通过 JNI 调 用 本 地 框架 ， 得 到 SensorService，SensorService 初 始 化 控制 流 各 
功能 。 

O new Ѕепѕог(): 建立 一 个 Sensor 对 象 ， 具 体 可 查阅 官网 API android.hardware.Sensor。 

口 sensors module get next sensor): 上 层 得 到 设备 支持 的 所 有 Sensor， 并 放 入 SensorList 链 表 。 

O new SensorThread(): 创建 Sensor 线 程 ， 当 应 用 程序 registerListener() 注 册 监听 器 的 时 候 开启 线程 
run()， 注 意 当 没有 数据 变化 时 线程 会 阻塞 。 


1. 实现 本 地 函数 


文件 android hardware SensorManager.cpp 的 功能 是 实现 文件 SensorManagerjava 中 的 native( 本 地 ) 
函数 ， 主 要 是 通过 调用 文件 SensorManager.cpp 和 文件 SensorEventQueue.cpp 中 的 相关 类 来 完成 相关 的 
工作 。 文 件 android_hardware_SensorManager.cpp 的 具体 实现 代码 如 下 所 示 。 
static struct { 
jclass clazz; 
jmethodID dispatchSensorEvent; 
} gBaseEventQueueClasslnfo; 
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namespace android { 


struct SensorOffsets 

{ 
jfieldID name; 
jfieldID vendor; 
jfieldID version; 
jfieldID handle; 
jfieldID type; 
jfieldID range; 
jfieldID resolution; 
jfieldID power; 
jfieldlD — minDelay; 

) gSensorOffsets; 

F 

* 下 面 的 方法 是 非 线程 安全 的 和 不 打算 用 的 

static void 

nativeClassInit (JNIEnv * епу, jclass this) 

{ 
jclass sensorClass = _env->FindClass("android/hardware/Sensor"); 
SensorOffsets& sensorOffsets = gSensorOffsets; 
sensorOffsets.name = _env->GetFieldID(sensorClass, "mName", "Ljava/lang/String;"); 
sensorOffsets.vendor = _env->GetFieldID(sensorClass, "mVendor", "Ljava/lang/String;"); 
sensorOffsets.version = _env->GetFieldID(sensorClass, "mVersion", "I"); 
sensorOffsets.handle = _env->GetFieldID(sensorClass, "mHandle", "I"); 
sensorOffsets.type = _env->GetFieldID(sensorClass, "mType", "I"); 
sensorOffsets.range = _env->GetFieldID(sensorClass, "mMaxRange", "Е"); 
sensorOffsets.resolution = env-»GetFieldlD(sensorClass, "mResolution","F"); 
sensorOffsets.power = _env->GetFieldID(sensorClass, "mPower", "F"); 
sensorOffsets.minDelay =_env->GetFieldID(sensorClass, "mMinDelay", "I"); 

} 

Static jint 


nativeGetNextSensor(JNIEnv “env, jclass clazz, jobject sensor, jint next) 


{ 


SensorManager& mgr(SensorManager::getlnstance()); 


Sensor const* const* sensorL ist; 
Size t count = mgr.getSensorList(&sensorList); 
if (size t(next) >= count) 

return -1; 


Sensor const* const list = sensorList[next]; 

const SensorOffsets& sensorOffsets(gSensorOffsets); 

jstring name = env->NewStringUTF (list->getName().string()); 
jstring vendor = env->NewStringUTF (list->getVendor().string()); 
env->SetObjectField(sensor, sensorOffsets.name, name); 


@ 


ТТЕ 


env->SetObjectField(sensor, sensorOffsets.vendor, vendor); 
env->SetintField(sensor, sensorOffsets. version, list->getVersion()); 
env->SetintField(sensor, sensorOffsets. handle, list->getHandle()); 
env->SetintField(sensor, sensorOffsets.type, list->getType()); 
env->SetFloatField(sensor, sensorOffsets.range, list->getMaxValue()); 
env->SetFloatField(sensor, sensorOffsets.resolution, list->getResolution()); 
env->SetFloatField(sensor, sensorOffsets.power, list->getPowerUsage()); 
env-»SetintField(sensor, sensorOffsets.minDelay, list->getMinDelay()); 


next++; 
return size_t(next) < count ? next : 0; 


} 
2. 处 理 客户 端 数据 


文件 frameworks\native\libs\gui\SensorManager.cpp 功能 是 提供 了 对 传感器 数据 部 分 的 操作 ,实现 了 
sensor data XXX() 格 式 的 函数 。 另 外 在 Native 层 的 客户 端 ， 文 件 SensorManager.cpp 还 负责 与 服务 端 
SensorService.cpp 之 间 的 通信 工作 。 文 件 SensorManagercpp 的 具体 实现 代码 如 下 所 示 。 


ANDROID_SINGLETON_STATIC_INSTANCE(SensorManager) 


SensorManager::SensorManager() 


: mSensorList(0) 

{ 
II we're not locked here, but it's not needed during construction 
assertStateLocked(); 

) 

SensorManager::~SensorManager() 

{ 
free(mSensorList); 

} 

void SensorManager::sensorManagerDied() 

{ 
Mutex::Autolock _I(mLock); 
mSensorServer.clear(); 
free(mSensorList); 
mSensorList = NULL; 
mSensors.clear(); 

) 


3. 处 理 服务 端 数据 


文件 frameworks\native\services\sensorservice\SensorService.cpp 能 够 实现 Sensor 真正 的 后 台 服 务 ， 
是 服务 端的 数据 处 理 中心 ,在 Android 的 传感器 系统 中 ,SensorService 作 为 一 个 轻 量 级 的 System Service, 
在 SystemServer 内 运行 ,在 system_init<system init.cpp> 中 调用 了 SensorService::instantiate()。 具 体 来 说 ， 
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SensorService 的 主要 功能 如 下 。 
(1) 通过 SensorService::instantiate 创建 实例 对 象 ， 并 增加 到 ServiceManager 中 ， 然 后 创建 并 启动 
线程 ， 并 执行 threadLoop。 
(2) threadLoop 从 sensor 驱动 获取 原始 数据 ， 然 后 通过 SensorEventConnection 把 事件 发 送 给 客户 端 。 
(3) BnSensorServer 的 成 员 函 数 负责 让 客户 端 获取 sensor 列表 和 创建 SensorEventConnection. 
文件 SensorService.cpp 的 具体 实现 代码 如 下 所 示 。 


namespace android { 


N 


const char SensorService::WAKE_LOCK NAME = "SensorService"; 


SensorService::SensorService() 
: mlnitCheck(NO_ INIT) 

{ 

} 


void SensorService::onFirstRef() 


{ 
ALOGD("nuSensorService starting..."); 


SensorDevice& dev(SensorDevice::getInstance()); 


if (dev.initCheck() == NO ERROR) { 
sensor t const* list; 
ssize t count = dev.getSensorList(&list); 
if (count > 0) ( 
ssize t orientationIndex = -1; 
bool hasGyro - false; 
uint32 t virtualSensorsNeeds = 
(1««SENSOR TYPE GRAVITY) | 
(1««SENSOR TYPE LINEAR ACCELERATION) | 
(1««SENSOR TYPE ROTATION VECTOR); 


mLastEventSeen.setCapacity(count); 
for (ssize t i-0 ; i<count ; i++) { 
registerSensor( new HardwareSensor(list[i]) ); 
Switch (list[i].type) ( 
case SENSOR TYPE ORIENTATION: 
orientationIndex = i; 
break; 
case SENSOR TYPE GYROSCOPE: 
hasGyro = true; 
break; 
case SENSOR TYPE GRAVITY: 
case SENSOR_TYPE_LINEAR_ACCELERATION: 
case SENSOR_TYPE_ROTATION_VECTOR: 
virtualSensorsNeeds &= -(1««list[i].type); 
break; 


#58 Android 传感器 系统 架构 详解 


// 它 是 安全 的 ， 在 这 里 实例 化 SensorFusion TR 
// 如 果 要 被 实例 化 后 ，H/W 传感器 已 注册 
const SensorFusion& fusion(SensorFusion::getlnstance()); 


if (hasGyro) ( 
NBS Android 的 虚拟 传感器 。 因 为 它们 是 实例 化 落后 于 HAL 的 传感器 ， 它 们 不 会 干扰 
应 用 程序 ， 除 非 它 们 看 起 来 特别 像 它 们 的 名 字 


registerVirtualSensor( new RotationVectorSensor() ); 
registerVirtualSensor( new GravitySensor(list, count) ); 
registerVirtualSensor( new LinearAccelerationSensor(list, count) ); 


1| 这 是 选项 

registerVirtualSensor( new OrientationSensor() ); 

registerVirtualSensor( new CorrectedGyroSensor(list, count) ); 
} 


II build the sensor list returned to users 
mUserSensorList = mSensorList; 


if (hasGyro) { 
II virtual debugging sensors are not added to mUserSensorList 
registerVirtualSensor( new GyroDriftSensor() ); 


} 
if (hasGyro && 
(virtualSensorsNeeds & (1<<SENSOR_TYPE_ROTATION_VECTOR))) { 
Il if we have the fancy sensor fusion, and it's not provided by the 
I| HAL, use our own (fused) orientation sensor by removing the 
II HAL supplied one form the user list. 
if (orientationIndex >= 0) ( 
mUserSensorList.removeltemsAt(orientationIndex); 
} 
} 
/调试 传感器 列表 


for (size_t i=0 ; i<mSensorList size() ; i++) ( 
Switch (mSensorList[i].getType()) { 

case SENSOR TYPE GRAVITY: 

case SENSOR TYPE LINEAR ACCELERATION: 

case SENSOR TYPE ROTATION VECTOR: 
if (strstr(mSensorList{i].getVendor().string(), "Google")) { 

mUserSensorListDebug.add(mSensorList[i]); 

) 
break; 

default: 
müUserSensorListDebug.add(mSensorList[i]); 
break; 


. 
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run("SensorService", PRIORITY URGENT DISPLAY); 
minitCheck = NO ERROR; 


} 
} 
} 
void SensorService::registerSensor(Sensorlnterface* s) 
{ 
sensors_event_t event; 
memset(&event, 0, sizeof(event)); 
const Sensor sensor(s->getSensor()); 
/添加 到 传感器 列表 〈 返 回 给 客户 端 ) 
mSensorList.add(sensor); 
/加 入 到 我 们 的 手柄 -> Sensorinterface 映射 
mSensorMap.add(sensor.getHandle(), s); 
// 创 建 mLastEventSeen 数组 中 的 一 个 条 目 
mLastEventSeen.add(sensor.getHandle(), event); 
} 
void SensorService::registerVirtualSensor(Sensorlnterface* s) 
{ 
registerSensor(s); 
mVirtualSensorList.add( s ); 
) 
SensorService::-SensorService() 
{ 
for (size_t i-0 ; i<mSensorMap.size() ; i++) 
delete mSensorMap.valueAt(i); 
} 


通过 上 述 实现 代码 ， 可 以 了 解 SensorService 服务 的 创建 、 启 动 过 程 ， 整 个 过 程 的 C/S 通信 架构 如 


图 5-5 所 示 。 


在 此 需要 注意 ,并 没有 在 系统 中 使 用 BpSensorServer， 即 使 从 ISensorServer.cpp 中 把 它 删除 也 不 会 
对 Sensor 的 工作 有 任何 影响 。 这 是 因为 它 的 工作 已 经 被 文件 SensorManager.cpp 所 取代 ,ServiceManager 
会 直接 获取 上 面 文件 System init 中 添加 的 SensorService 对 象 。 


4. 封装 HAL 层 的 代码 


在 Android 系统 


,通过 文件 frameworks \native\services\sensorservice\SensorDevice.cpp 封装 了 HAL 


层 的 代码 ， 此 文件 的 主要 功能 如 下 : 
口 获取 sensor 列 表 (getSensorList) 。 
口 获取 sensor 事 件 (poll) 。 
口 Enable 或 Disable sensor (activate)。 
口 设置 delay 时 间 。 


e 


лы 


+ onFirstRefl)- void 
+ onincStongAttempted() : void 
+ onLastStrongRefi) : void 

+ onLastWeaiRefi) : void 


Binder 


isBindecAlivel): void 
localBinder() : void + asBinder) : sp<iBinde> 
remcteBinder) : void 
iransadi) : void 


nm 


+ westeSensecEventConnection(): ISenssrEventConnection 
* getSensorL isti): VectorcSansom 


v4 WV. 


Bninterface 


+ queryLocalintertace() : sp«linterface» 


“asked + instantiate) void 


+ publish) : void 
+ publishAndJoinThresdPooll) : void 
+ shutdown() : void 


+ qresteSensorEventConnection() : void 
+ getSensorList) : void 


A 


+ ceateSensorEventConnedtion) void 
+ getSensoristi : уса тым): void 
+ gatSansciName : void threadLoopi) : void 
+ getSevice ipe) void 
+ OnFirstRef() : void 

+ onTransadi): void 

+ registerSensor() void 
+ ieadLocpi): void 


cesteEventQueve() : void 


+ geiDefsultSenscr) : void 
+ getSensotist) : void 


图 5-5 C/S 通信 架构 图 


文件 SensorDevice.cpp 的 主要 实现 代码 如 下 所 示 。 
status_t SensorDevice::activate(void* ident, int handle, int enabled) 


{ 


if (ImSensorDevice) return NO INIT; 
status terr(NO ERROR); 
bool actuateHardware - false; 


Info& info( mActivationCount.editValueFor(handle) ); 


ALOGD IF(DEBUG CONNECTIONS, 


Android AFARA 


"SensorDevice::activate: ident=%p, handle=0x%08x, enabled=%d, count=%d", 
ident, handle, enabled, info.rates.size()); 


if (enabled) { 
Mutex::Autolock l(mLock); 
ALOGD_IF(DEBUG_CONNECTIONS, "... index=%ld", 
info.rates.indexOfKey(ident)); 


if (info.rates.indexOfKey (ident) < 0) ( 
info.rates.add(ident, DEFAULT EVENTS PERIOD); 
if (info.rates.size() == 1)( 
actuateHardware - true; 
} 
) else { 
/传感器 已 经 激活 此 IDENT 
} 
) else { 
Mutex::Autolock _I(mLock); 
ALOGD IF(DEBUG CONNECTIONS, "... index=%ld", 
info.rates.indexOfKey(ident)); 


Ssize t idx = info.rates.removeltem(ident); 
if (idx >= 0) ( 
if (info.rates.size() == 0) { 
actuateHardware = true; 


} 
) else { 
// 没 有 启用 这 个 传感器 的 ident 
} 
} 
if (actuateHardware) { 
ALOGD IF(DEBUG CONNECTIONS, "\t>>> actuating h/w"); 
err = mSensorDevice->activate(mSensorDevice, handle, enabled); 
ALOGE IF(err, "Error %s sensor %d (%s)", 
enabled ? "activating" : "disabling", 
handle, strerror(-err)); 
} 
{// 范 围 为 锁 
Mutex::Autolock _I(mLock); 
nsecs tns = info.selectDelay(); 
mSensorDevice->setDelay(mSensorDevice, handle, ns); 
} 
return err; 


} 


status t SensorDevice::setDelay(void* ident, int handle, int64 t ns) 
{ 


e. 
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if (ImSensorDevice) return NO INIT; 

Mutex::Autolock l(mLock); 

Info& info( mActivationCount.editValueFor(handle) ); 

status terr = info.setDelayForldent(ident, ns); 

if (err « 0) return err; 

ns - info.selectDelay(); 

return mSensorDevice->setDelay(mSensorDevice, handle, ns); 


} 


int SensorDevice::getHalDeviceVersion() const { 
if (ImSensorDevice) return -1; 


return mSensorDevice->common. version; 


status_t SensorDevice::Info::setDelayForldent(void* ident, int64_t ns) 
{ 
ssize t index = rates.indexOfKey(ident); 
if (index « 0) ( 
ALOGE("Info::setDelayForldent(ident=%p, ns=%lld) failed (96s)", 
ident, ns, strerror(-index)); 
return BAD INDEX; 
) 
rates.editValueAt(index) 7 ns; 
retum NO. ERROR; 
) 


nsecs t SensorDevice::Info::selectDelay() 
{ 
nsecs tns = rates.valueAt(0); 
for (size t i=1 ; i<rates.size() ; i++) ( 
nsecs_t cur = rates.valueAt(i); 
if (cur < ns) { 
ns = сиг; 
} 
} 


delay = ns; 
return ns; 


II 
); // namespace android 


这 样 SensorService 会 把 任务 交 给 SensorDevice, ТЇ SensorDevice 会 调用 标准 的 抽象 层 接口 。 由 此 
可 见 ，Sensor 架构 的 抽象 层 接 口 是 最 标准 的 一 种 ， 它 很 好 地 实现 了 抽象 层 与 本 地 框架 的 分 离 。 


5. 处 理 消息 队列 
在 Android 传感器 系统 中 ， 文 件 frameworks\native\libs\gui\SensorEventQueue.cpp 的 功能 是 处 理 消息 。 
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文件 SensorEventQueue.cpp 能 够 在 创建 其 实例 时 传 入 SensorEventConnection 实例 ,SensorEventConnection 
继承 于 ISensorEventConnection 。 SensorEventConnection 其 实 是 客户 端 调 用 SensorService 的 
createSensorEventConnection() 方 法 创建 的 , 是 客户 端 与 服务 端 沟通 的 桥梁 , 通过 这 个 桥梁 可 以 完成 如 下 
功能 : 

口 获取 管道 的 句柄 。 

о 往 管道 读 写 数据 。 

а 通知 服务 端 对 Sensor 使 能 。 

文件 frameworks\native\libs\gui\SensorEventQueue.cpp 的 具体 实现 代码 如 下 所 示 。 


wawa — 


namespace android ( 


SensorEventQueue::SensorEventQueue(const sp<ISensorEventConnection>& connection) 
: mSensorEventConnection(connection) 


{ 
} 
SensorEventQueue::~SensorEventQueue() 
{ 
} 
void SensorEventQueue::onFirstRef() 
{ 
mSensorChannel = mSensorEventConnection->getSensorChannel(); 
} 
int SensorEventQueue::getFd() const 
{ 
return mSensorChannel->getFd(); 
} 


ssize_t SensorEventQueue::write(const sp<BitTube>& tube, 
ASensorEvent const* events, size_t numEvents) { 
return BitTube::sendObjects(tube, events, numEvents); 


} 
ssize_t SensorEventQueue::read(ASensorEvent* events, size_t numEvents) 
{ 
return BitTube::recvObjects(mSensorChannel, events, numEvents); 
} 


sp<Looper> SensorEventQueue::getLooper() const 


{ 
Mutex::Autolock _I(mLock); 


if (mLooper == 0) { 


mLooper = new Looper(true); 
e. 


mLooper-»addFd(getFd(), getFd(), ALOOPER EVENT. INPUT, NULL, NULL); 
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} 


return mLooper; 


} 


status_t SensorEventQueue::waitForEvent() const 
{ 

const int fd = getFd(); 

sp<Looper> looper(getLooper()); 


int events; 
int32_t result; 
do { 
result = looper->pollOnce(-1, NULL, &events, NULL); 
if (result == ALOOPER_POLL_ERROR) { 
ALOGE("SensorEventQueue::waitForE vent error (errno=%d)", errno); 
result = -EPIPE; // unknown error, so we make up one 


break; 

} 

if (events & ALOOPER_EVENT_HANGUP) { 
// the other-side has died 
ALOGE("SensorEventQueue::waitForEvent error HANGUP"); 
result = -EPIPE; // unknown error, so we make up one 
break; 

} 


} while (result != fd); 


return (result == fd) ? status_t(NO_ERROR) : result; 


} 
status_t SensorEventQueue::wake() const 
{ 
sp<Looper> looper(getLooper()); 
looper->wake(); 
retum NO_ERROR; 
} 


status_t SensorEventQueue::enableSensor(Sensor const* sensor) const { 
return mSensorEventConnection->enableDisable(sensor->getHandle(), true); 


} 


status_t SensorEventQueue::disableSensor(Sensor const* sensor) const { 
return mSensorEventConnection->enableDisable(sensor->getHandle(), false); 


} 


status_t SensorEventQueue::enableSensor(int32_t handle, int32_t us) const { 
status_t err = mSensorEventConnection->enableDisable(handle, true); 
if (ет == NO_ERROR) { 
mSensorEventConnection->setEventRate(handle, us2ns(us)); 
} 


return err; 


М яая 


status_t SensorEventQueue::disableSensor(int32_t handle) const { 
return mSensorEventConnection->enableDisable(handle, false); 
} 


status_t SensorEventQueue::setEventRate(Sensor const* sensor, nsecs_t ns) const { 
return mSensorEventConnection->setEventRate(sensor->getHandle(), ns); 
} 


I 
}; // namespace android 
由 此 可 见 ，SensorManager 负责 控制 流 ， 通 过 C/S 的 Binder 机 制 与 SensorService 实现 通信 。 具 体 


过 程 如 图 5-6 所 示 。 
SensorManage 
/frameworks/ba 
se/libs/gui/Sens 
orManager.cpp 


: SensorEventQueue 
- 


onnection >getSensorChannell) 


5-6 SensorManager 控制 流 的 处 理 流程 
而 SensorEventQueue 负责 数据 流 ， 功 能 是 通过 管道 机 制 来 读 写 底层 的 数据 。 具 体 过 程 如 图 5-7 所 示 。 


图 5-7 SensorEventQueue 数据 流 的 处 理 流程 
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5.1.4 HAL 层 详解 


在 Android 系统 中 ，HAL 层 提 供 了 Android 独立 于 具体 硬件 的 抽象 接口 。 其 中 HAL 层 的 头 文件 路 
hardware/libhardware/include/hardware/sensors.h 
而 具体 实现 文件 需要 开发 者 个 人 编写 ， 具 体 可 以 参考 : 
hardware\invensense\libsensors_iio\sensors_mpl.cpp 
文件 sensors.h 的 主要 实现 代码 如 下 所 示 。 
typedef struct { 
union { 
float v[3]; 
struct { 


float azimuth; 
float pitch; 
float roll; 
y: 

In 

int8 t status; 

uint8 t reserved[3]; 

) sensors vec t; 


p 
* 未 校准 陀螺 仪 和 磁 强 计数 据 事件 
*/ 

typedef struct { 

union { 
float uncalib[3]; 
struct ( 
float x uncalib; 
float y uncalib; 
floatz uncalib; 

} 

y 

union { 

float bias[3]; 
struct ( 
float x bias; 
float y bias; 
floatz bias; 
y: 
y 


) uncalibrated_event t; 
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p 
* 各 种 类 型 的 传感器 数据 中 的 联合 
* 可 以 返回 
Ki 

typedef struct sensors event t( 

int32 t version; 
int32 t sensor; 


六 传感器 类 型 */ 
int32_t type; 
int32 t reserved0; 


P 事件 微 秒 */ 
int64_t timestamp; 
union { 
float data[16]; 


sensors vec t acceleration; 
sensors vec t magnetic; 
sensors vec t orientation; 
sensors vec t gyro; 


float temperature; 
float distance; 

float light; 

float pressure; 

float relative humidity; 
uint64 t Step counter; 


uncalibrated event t uncalibrated gyro; 


uncalibrated event t uncalibrated magnetic; 
k 
uint32 t reserved1[4]; 
) sensors event t; 


struct sensor t; 
Struct sensors module t ( 
struct hw module t common; 
int (get sensors list)(struct sensors module t* module, 
struct sensor t const** list); 


y: 


struct sensor 1{ 
const char* name; 


const сһаг* vendor; 


e 


h 
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int version; 

int handle; 

int type; 

float maxRange; 
float resolution; 
float power; 

int32 t minDelay; 
void* reserved[8]; 


struct sensors poll device tí 


} 


struct hw_device_t common; 

int (*activate)(struct sensors_poll_device_t *dev, 
int handle, int enabled); 

int (*setDelay)(struct sensors_poll_device_t *dev, 
int handle, int64_t ns); 

int (*poll)(struct sensors poll device t *dev, 
sensors event t* data, int count); 


typedef struct sensors poll device 1 í 


union ( 
struct sensors poll device t v0; 


struct ( 
struct hw device t common; 
int (*activate)(struct sensors poll device t *dev, 
int handle, int enabled); 


int (*setDelay)(struct sensors poll device t *dev, 
int handle, int64 t period ns); 


int (*poll)(struct sensors poll device t *dev, 
sensors event t* data, int count); 
Я 
Е 
int (*batch)(struct sensors_poll_device_1* dev, 
int handle, int flags, int64_t period_ns, int64_t timeout); 


void (*reserved procs[8])(void); 


) sensors poll device 1 t; 


/* 用 于 打开 和 关闭 的 装置 方便 的 API */ 


89 


i» 
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static inline int sensors_open(const struct hw_module_t* module, 
struct sensors_poll_device_t** device) ( 
return module->methods->open(module, 
SENSORS HARDWARE POLL, (struct hw device t**)device); 
} 


static inline int sensors_close(struct sensors_poll_device_t* device) { 
return device->common.close(&device->common); 


} 


static inline int sensors_open_1(const struct hw_module_t* module, 
sensors_poll_device_1_t** device) { 
return module->methods->open(module, 
SENSORS_HARDWARE_POLL, (struct hw_device_t**)device); 
} 


static inline int sensors_close_1(sensors_poll_device_1_t* device) { 
return device->common.close(&device->common); 


} 
. END DECLS 


#endif // ANDROID SENSORS INTERFACE Н 
而 具体 的 实现 文件 是 Linux Kernel 层 ， 也 就 是 具体 的 硬件 设备 驱动 程序 ， 例 如 可 以 将 其 命名 为 
sensors.c， 然 后 编写 如 下 定义 struct sensors. poll device t 的 代码 。 
struct sensors poll device tí 
struct hw device t common; 


ТА НЕ — MERRE 
int (*activate)(struct sensors poll device t *dev, 
int handle, int enabled); 


// 对 于 一 个 给 定 的 传感器 ， 设 置 在 微 秒 传感器 事件 之 间 的 延迟 
int (*setDelay)(struct sensors_poll_device_t *dev, 
int handle, int64_t ns); 


// 返 回 传感器 数据 的 数组 
int (*poll)(struct sensors poll device t *dev, 
sensors event t* data, int count); 
y: 
也 可 以 编写 如 下 定义 struct sensors module t 的 代码 。 
struct sensors_module_t { 
struct hw_module_t common; 


p 
* 枚 举 所 有 可 用 的 传感器 。 这 份 名 单 是 在 “名 单 ” 返 回 
*@ 传 感 器 在 列表 中 返回 数 
Ef 

int (get sensors list)(struct sensors module t* module, 

struct sensor t const** list); 


e 


也 可 以 编写 如 下 定义 struct sensor t 的 代码 。 
struct sensor t( 
const char* name; 
int version; 
int handle; 
int type; 
float maxRange; 
float resolution; 
float power; 
int32 t minDelay; 
void* reserved[8]; 
Е 
也 可 以 编写 如 下 定义 struct sensors. event t 的 代码 。 
typedef struct { 
union { 
float v[3]; 
struct { 
float x; 
float y; 
float 2; 
y: 
struct ( 
float azimuth; 
float pitch; 
float roll; 
y 
y; 
int8 t status; 
uint8 t reserved[3]; 
} sensors vec t; 
typedef struct sensors event t( 
int32 t version; 


int32 t sensor; 


int32 ttype; 
int32 t reserved0; 


int64_t timestamp; 

union { 
float data[16]; 
sensors vec t acceleration; 
sensors vec t magnetic; 


sensors vec t orientation; 


sensors vec t gyro; 
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float temperature; 
float distance; 
float light; 
float pressure; 
float relative humidity; 
Hae reserved1[4]; 


) sensors event t; 


也 可 以 编写 如 下 定义 struct sensors module t 的 代码 。 
static const struct sensor t sSensorList[] = { 
( "MMA8452Q 3-axis Accelerometer", 
"Freescale Semiconductor", 
1, SENSORS_HANDLE_BASE+ID_A, 
SENSOR TYPE ACCELEROMETER, 4.0f*9.81f, (4.0f*9.81f)/256.0f, 0.2f, 0, {}}, 
("AK8975 3-axis Magnetic field sensor", 
"Asahi Kasei", 
1, SENSORS HANDLE BASE+ID M, 
SENSOR TYPE MAGNETIC FIELD, 2000.0f, 1.0f/16.0f, 6.8f, 0, {}}, 
{ "АК8975 Orientation sensor", 
"Asahi Kasei", 
1, SENSORS HANDLE ВАЅЕ+0 О, 
SENSOR TYPE ORIENTATION, 360.0f, 1.0f, 7.0f, 0, () ), 


("ST 3-axis Gyroscope sensor", 
"STMicroelectronics", 
1, SENSORS HANDLE BASE*ID СҮ, 
SENSOR TYPE GYROSCOPE, RANGE GYRO, CONVERT GYRO, 6.1f, 1190, { } ), 


("AL3006Proximity sensor", 
"Dyna Image Corporation", 
1, SENSORS HANDLE BASE*ID P, 
SENSOR TYPE PROXIMITY, 
PROXIMITY THRESHOLD CM, PROXIMITY THRESHOLD CM, 
0.5f, 0, (3), 


("AL3006 light sensor", 
"Dyna Image Corporation", 
1, SENSORS HANDLE BASE+ID L, 
SENSOR TYPE LIGHT, 10240.0f, 1.0f, 0.5f, 0, () ), 


k 


static int open sensors(const struct hw module t* module, const char* name, 
struct hw device t** device); 


Static int sensors get sensors list(struct sensors module t* module, 
Struct sensor t const** list) 


{ 


e. 
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*list = sSensorList; 
retum ARRAY_SIZE(sSensorList); 
} 


static struct hw_module_methods_t sensors_module_methods = { 
.open = open sensors 


y: 


const struct sensors_module_t HAL_MODULE_INFO_SYM = ( 
.common = ( 
‘tag = HARDWARE MODULE TAG, 
.version major = 1, 
.version minor = 0, 
‘id = SENSORS_HARDWARE_MODULE_ID, 
.name = "MMA8451Q & AK8973A & gyro Sensors Module", 
.author = "The Android Project", 
.methods = &sensors_module_methods, 
А 
.get_sensors_list = sensors get sensors list 


y 


static int open_sensors(const struct hw module t* module, const char* name, 
struct hw_device_t** device) 
{ 


} 
到 此 为 止 ， 整 个 Android 系统 中 传感器 模块 的 源码 分 析 完毕 。 由 此 可 见 ， 整 个 传感器 系统 的 总 体 
调用 关系 如 图 5-8 所 示 。 


return init_nusensors(module, device); // 待 后 面 讲解 
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5-8 传感器 系统 的 总 体 调用 关系 


Aros aa RE 


客户 端 读 取 数据 时 的 调用 时 序 如 图 5-9 所 示 。 


6 :sansors_madule_get_nextisensorg 


i { ~ 7 gatSersorListO : 


9: rige епт) 


10 : startLocked() 


图 5-9 客户 端 读 取 数据 时 的 调用 时 序 图 
服务 器 端的 调用 时 序 如 图 5-10 所 示 。 
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图 5-10 服务 器 端的 调用 时 序 图 
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ЁШ 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 5 章 \Android 传感器 应 用 开发 基础 .avi 

在 本 章 前 面 的 内 容 中 ， 已 经 详细 讲解 了 Android 系统 中 传感器 系统 的 架构 知识 。 在 现实 应 用 中 ， 
传感器 系统 在 外 设 项 目 开 发 过 程 、 可 穿戴 设备 和 家 居 设 备 中 得 到 了 广泛 的 应 用 。 本 节 将 详细 讲解 开发 
Android 传感器 应 用 程序 的 基础 知识 ， 介 绍 使 用 传感器 技术 开发 外 设 项 目 开 发 过 程 应 用 程序 的 基本 流 
程 ， 为 读者 学 习 本 书后 面 的 知识 打下 坚实 的 基础 。 
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在 安装 Android SDK 后 ， 依 次 打开 安装 目录 中 的 如 下 帮助 文件 : 
android SDK/sdk/docs/reference/android/hardware/Sensor.html 


在 此 文件 中 列 出 了 Android 传感器 系统 所 包含 的 所 有 传感器 类 型 ， 如 图 5-11 所 示 。 


Summary 
Android APIS APH level, 16 = 


апа уезше 


android graphics drawable E AC = 
нзр E int TYPE ACCELEROMETER A constant describing an accelerometer sensor type. 
it TYPE ALL А constant describing all sensor types. 
i eg ТҮРЕ AMBIENT. TEMPERATURI 
ea int = AMBIENT. TEMPE! E А constant. chim ап ambient temperature sensor type. 
android hardware location int TYPE САМЕ ROTATION VECTOR Identical to 7772. SOTATION_yECTOR except that it doesnt use the geomagnetic field. 
android hardware usb _ 
int TYPE GRAVITY A constant describing a gravity sensor b 
android inputmethodservice = hm m 
android location int ТҮРЕ GYROSCOPE A constant describing a gyroscope sensor type 
ойк imt TYPE GYROSCOPE UNCALIBRATED A constant describing a gyroscope uncalibrated sensor type. 
android media.audiofx 
android medie effect int ТУРЕ LIGHT A constant describing a light sensor type. 
int TYPE LINEA ACCELERATION A constant describing a linear acceleration sensor type. 
Camera Area 
Camera Cameralnfo int A constant describing a magnetic field sensor type. 
Camera Face 
int A constant describing a magnetic fled uncalibrated sensor type. 
Camera Parameters мәз ins уре. 
Camera Size int This constant was deprecated in API evel 8 use Senscrlssazer. getOrientaticn|) instead, 
аи int — TVPF PRESSURE А constant describing a pressure sensor type 
ensor 
ттт int TYPE PROXIMITY A constant describing a proximity sensor type. 
ск int TYPE RELATNE HUMIDITY A constant describing a reletive humidity sensor type. 
riggerEvent 
Te = LSS ere 
int ТҮР! NIFICANT MOTION Aconstant describing the significant motion trigger sensor. 
int ТҮРЕ TEMPERATURE This constant was deprecated in API level 14, use Sensor. TYPE_ANBTENT_TENPERATURE instead 


Use Tree Navigation leo 
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另外 ,也 可 以 直接 在 线 登 录 http://developer.android.com/reference/android/hardware/Sensor.html 来 查 
看 。 由 此 可 见 ， 在 当前 最 新 (作者 写 稿 时 最 新 ) 版 本 Android 4.4 中 一 共 提供 了 18 种 传感器 API。 各 个 
类 型 的 具体 说 明 如 下 。 

(1) TYPE_ACCELEROMETER: 加 速度 传感器 ， 单 位 是 m/s* ， 测 量 应 用 于 设备 X、Y、Z 轴 上 
的 加 速度 ， 又 叫做 G-sensor。 

(2) TYPE AMBIENT TEMPERATURE: 温度 传感器 ， 单 位 是 C， 能 够 测量 并 返回 当前 的 温度 。 

(3) TYPE GRAVITY: 重力 传感器 ， 单 位 是 m/s ， 用 于 测量 设备 X、Y、Z 轴 上 的 重力 ， 也 叫 
GV-sensor， 地 球 上 的 数值 是 9.8m/s* ， 也 可 以 设置 其 他 星球 。 

(4) TYPE GYROSCOPE: 陀螺 仪 传感器 ， 单 位 是 radls， 能 够 测量 设备 X、Y、Z 三 轴 的 角 加 速 


° 


度数 据 。 

(5) TYPE LIGHT: 光线 感应 传感器 ， 单 位 是 kx， 能 够 检测 周围 的 光线 强度 ， 在 手机 系统 中 主要 
用 于 调节 LCD 亮度 。 

(6) TYPE LINEAR ACCELERATION: 线性 加 速度 传感器 ， 单 位 是 m/s* ， 能 够 获取 加 速度 传 感 
器 去 除 重力 的 影响 得 到 的 数据 。 

(7) TYPE MAGNETIC FIELD: 磁场 传感器 ， 单 位 是 wT ( 微 特 斯 拉 ) ， 能 够 测量 设备 周围 3 个 
物理 轴 (X, Y, Z) 的 磁场 。 

(8) TYPE ORIENTATION: 方向 传感器 ， 用 于 测量 设备 围绕 3 个 物理 轴 CX, Y, Z) 的 旋转 角 
度 ， 在 新 版 本 中 已 经 使 用 SensorManager.getOrientation() 蔡 代 。 

(9) TYPE PRESSURE: 气压 传感器 ， 单 位 是 hPa〈 百 帕斯卡 ) ， 能 够 返回 当前 环境 下 的 压强 。 

(10) TYPE_PROXIMITY: 距离 传感器 ， 单 位 是 cm， 能 够 测量 某 个 对 象 到 屏幕 的 距离 。 可 以 在 
打 电 话 时 判断 人 耳 到 电话 屏幕 的 距离 ， 以 关闭 屏幕 而 达到 省 电 功 能 。 

(11) TYPE RELATIVE HUMIDITY: 湿度 传感器 ， 单 位 是 %， 能 够 测量 周围 环境 的 相对 湿度 。 

(12) TYPE_ROTATION_VECTOR: 旋转 向 量 传感器 ， 旋 转 矢量 代表 设备 的 方向 ， 是 一 个 将 坐标 
轴 和 角度 混合 计算 得 到 的 数据 。 

(13) TYPE TEMPERATURE: 温度 传感器 ， 在 新 版 本 中 被 TYPE AMBIENT TEMPERATURE 
替换 。 

(14) TYPE ALL: 返回 所 有 的 传感器 类 型 。 

(15) TYPE GAME ROTATION VECTOR: 除了 不 能 使 用 地 磁场 之 外 ， 和 TYPE ROTATION VECTOR 
的 功能 完全 相同 。 

(16) TYPE_GYROSCOPE_UNCALIBRATED: 提供 了 能 够 让 应 用 调整 传感器 的 原始 值 ， 定 义 了 
一 个 描述 未 校准 陀螺 仪 的 传感器 类 型 。 

(17) TYPE MAGNETIC FIELD UNCALIBRATED: 和 TYPE GYROSCOPE UNCALIBRATED 
相似 ， 也 提供 了 能 够 让 应 用 调整 传感器 的 原始 值 ， 定 义 了 一 个 描述 未 校准 陀螺 仪 的 传感器 类 型 。 

(18) TYPE_SIGNIFICANT_MOTION: 运动 触发 传感器 ， 应 用 程序 不 需要 为 这 种 传感器 触发 任 
何 唤醒 锁 。 能 够 检测 当前 设备 是 否 运动 ， 并 发 送 检测 结果 。 


5.2.2 ”模拟 器 测试 工具 一 一 SensorSimulator 


在 进行 和 传感器 相关 的 开发 工作 时 ， 使 用 SensorSimulator 测试 工具 可 以 提高 开发 效率 。 测 试 工具 
SensorSimulator 是 一 个 开源 免费 的 传感器 工具 ， 通 过 该 工具 可 以 在 模拟 器 中 调试 传感器 的 应 用 。 搭 建 
SensorSimulator 开发 环境 的 基本 流程 如 下 。 

(1) 下 载 SensorSimulator， 读 者 可 从 http://code.google. @ Openintents . 
com/p/openintents/wiki/SensorSimulator 网 站 找到 该 工具 的 下 载 а [omon wa ese sms 
链接 。 笔 者 下 载 的 是 sensorsimulator-1.1.1.zip 版 本 ， 如 图 5-12 Гое езент ET 
所 示 。 

(2) 将 下 载 好 的 SensorSimulator 解压 到 本 地 根 目录 ， 例 
如 C 盘 的 根 目录 。 

(3) 向 模拟 器 安装 sensorsimulatorsettings-1.1.1.apk。 首先 5-12 下 载 sensorsimulator1.1.1.zip 


e 


imulat 1 1zip  SensoSimuator 1.1.0 
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在 操作 系 乡 中 依次 选择 “开始 ”| “运行” 命令 进入 “运行 ”对 话 框 。 
(4) 在 “运行 ”对 话 框 中 输入 cmd 进入 cmd 命令 行 ， 之 后 通过 cd 命令 将 当前 目录 导航 到 


sensorsimulatorsettings-1.1.1.apk 目录 下 ， 然 后 输入 下 列 命令 向 模拟 器 安装 该 apk。 
adb install sensorsimulatorsettings-1.1.1.apk 


在 此 需要 注意 的 是 ， 安 装 apk 时 ， 一 定 要 保证 模拟 器 正在 运行 才 可 以 ， 安 装 成 功 后 会 输出 Success 
提示 ， 如 图 5-13 所 示 。 


«c» 版 权 所 有 1985-2001 Microsoft Corp. 


C:\Documents and Settings Adninistrator’cd c:\sensorsimulator-1.1.1\bin 
IC: \sensorsinulator-1.1.1\bin>adb install s sinulatorsettings-i.1.1.apk 


96 KB/s (68397 bytes in 8.689s> 
pkg: /data/local/tmp. wlatorsett ings-1.1.1.apk 


图 5-13 安装 apk 


接 下 来 开始 配置 应 用 程序 ， 假 设 我 们 要 在 项 目 jiaSCH 中 使 用 SensorSimulator， 则 配置 流程 如 下 。 
(1) 在 Eclipse 中 打开 项 目 jiaSCH， 然 后 为 该 项 目 添加 JAR 包 ， 使 其 能 够 使 用 SensorSimulator 
[ 具 的 类 和 方法 。 添 加 方法 非常 简单 ， 在 Eclipse 的 Package Explorer 中 找到 该 项 目的 文件 夹 jiaSCH, 
然后 右键 单 击 该 文件 夹 , 在 弹出 的 快捷 菜单 中 选择 Properties 命令 , 弹出 如 图 5-14 所 示 的 Properties for 
jiaS 对 话 框 。 


i Android 4I» 


Resource 
Android Project Build Target E 
RIPE [Target Nane Vendor Гает Тат] 

由 .Java Code Style О Android 1.1 Android Open Source Project 11 2 

由 Juws Conpiler О Android 1.5 Android Open Source Project 1.5 3 
aan 351 О Android 1.6 Android Üpen Source Project 1.6 4 

T e. О Android 2.0 Android Üpen Source Project 2.0 5 
Javadoc Location О android 2.0.1 Android Open Source Project 2.0.1 6 
Project References [l Android 2.1-wpdetel Android Open Source Project 2.1-updatel T 
Refactoring History D android 2.2 Android Open Source Project 2.2 8 
Run/Debug Settings О Android 2.2 Android Open Source Project 2.2 8 

由 Task Repository О Google APIs Google Inc 2.2 8 
Task Tags [П GALAXY Tab Addon Sansung Electronics Co., Ltd 22 8 
Validation [2 android 2.3 Android Üpen Source Project 2.3 9 
WikiText О Google APIs Google Inc 2.3 9 

О Android 2.3.3 Android Üpen Source Project 2.3.3 10 
О Android 3.0 Android Üpen Source Project 3.0 и 
О Android 3.1 Android Open Source Project 3.1 12 
О Google APIs Google Inc. 3.1 12 
О Android 3.2 Android Open Source Project 3.2 13 


图 5-14 Properties for jiaS 对 话 框 


(2) 选择 左面 的 Java Build Path 选项 ， 然 后 选择 Libraries 选项 卡 ， 如 图 5-15 所 示 。 


[е бїт tec 


E Java Code Style 89 йі sensorsimulator-Lib. jar - D: RARE V Android SensorSir| 
E Java Compiler E Bà Android 2.3 


Project References 


图 5-15 Libraries 选项 卡 


(3) 单 击 Add Extemal JARs 按钮 ， 在 弹出 的 JAR Selection 对 话 框 中 找到 sensorsimulator 安装 目 
录 下 的 sensorsimulator-lib-1.1.1jar， 并 将 其 添加 到 该 项 目 中 ， 如 图 5-16 所 示 。 

(4) 开始 启动 sensorsimulatorjar， 并 对 手机 模拟 器 上 的 SensorSimulatorSettings 进行 必要 的 配置 。 
首先 在 C:\sensorsimulator-1.1.1\bin 目录 下 找到 sensorsimulatorjar 并 启动 ,运行 后 的 界面 如 图 5-17 所 示 。 


[2] x] 


arm 
| Openintents Sensor Simulator 


| n 


| @ yaw pich C roll ich © move 


[sensorsimilator-lit-1.1.1. jar 


| Penator 349 00,-60.00, 0.00 


eceleromeler 206848430 |А 
vagretc feld: 12.40,.27.55, -28.45 


图 5-16 添加 需要 的 JAR 包 图 5-17 传感器 的 模拟 器 


(5) 接 下 来 开始 进行 手机 模拟 器 和 SensorSimulator 的 连接 配置 工作 , 运行 手机 模拟 器 上 安装 好 的 
Sensorsimulatorsettings-1.1.1.apk， 如 图 5-18 所 示 。 

(6) 在 图 5-18 中 输入 SensorSimulator 启动 时 显示 的 IP 地 址 和 端口 号 ， 单 击 屏幕 右上 角 的 Testing 
按钮 后 会 来 到 测试 连接 界面 ， 如 图 5-19 所 示 。 

Ст) 单 击 屏幕 上 的 Connect 按钮 进入 下 一 界面 ， 如 图 5-20 所 示 。 在 此 界面 中 可 以 选择 需要 监听 的 
传感器 ， 如 果 能 够 从 传感器 中 读 取 到 数据 ， 说 明 SensorSimulator 与 手机 模拟 器 连接 成 功 ， 可 以 测试 自 
己 开发 的 应 用 程序 了 。 


@ 
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a Ham () 7:49 
nsor Simulator settings 
© 
Settings 


Disconnect 


dame 7:44 


Fastest w 


Bes Fastest v 


图 5-18 运行 手机 模拟 器 上 的 图 5-19 测试 连接 界面 图 5-20 连接 界面 


Sensorsimulatorsettings-1.1.1.apk 


到 此 为 止 ， 使 用 Eclipse 结合 SensorSimulator 配置 传感器 应 用 程序 的 基本 流程 介绍 完毕 。 


52.3 ”实战 演练 一 一 检测 当前 设备 支持 的 传感器 


在 接 下 来 的 实例 中 ， 将 演示 在 Android 设备 中 检测 当前 设备 支持 传感器 类 型 的 方法 。 


实例 | 功能 源码 路 径 
实例 5-1 检测 当前 设备 支持 的 传感器 光盘 :vdaima\S\SensorEX 


本 实例 的 功能 是 检测 当前 设备 支持 的 传感器 类 型 ， 具 体 实现 流程 如 下 。 
(1) 布局 文件 main.xml 的 具体 实现 代码 如 下 所 示 。 

<linearlayout android:layout_height="fill_parent" android:layout_width="fill_ parent" android:orientation="vertical" 

xmins:android="http://schemas.android.com/apk/res/android"> 

<textview android:layout_height="wrap_content" 
android:layout width-"fill parent" android:text="" 
android:id="@+id/TextView01" 

> 

</textview> 

</linearlayout> 
(2) 主 程序 文件 MainActivity.java 的 具体 实现 代码 如 下 所 示 。 

public class MainActivity extends Activity { 


/** Called when the activity is first created. */ 

@SuppressWarnings("deprecation") 

@Override 

public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.main); 


/准备 显示 信息 的 UI 组 建 
final TextView tx1 = (TextView) findViewByld(R.id. TextView01); 


a Android 外 设 开发 实战 


// 从 系统 服务 中 获得 传感器 管理 器 
SensorManager sm = (SensorManager) getSystemService(Context.SENSOR SERVICE); 


/从 传感器 管理 器 中 获得 全 部 的 传感器 列表 
List<Sensor> allSensors = sm.getSensorList(Sensor.TYPE ALL); 


// 显 示 有 多 少 个 传感器 
tx1.setText(" 经 检测 该 手机 有 " + allSensors.size() + "个 传感器 ， 它 们 分 别 是 : \n"); 


// 显 示 每 个 传感器 的 具体 信息 


for (Sensor s : allSensors) { 


String tempString ="\n"+" 设备 名 称 : "+ s.getName() + \n" +" 设备 版 本 : "+ 
s.getVersion() + "\п" +" 供应 商 :“" 
+ s.getVendor() + ^n"; 


switch (s.getType()) { 
case Sensor. TYPE_ACCELEROMETER: 
tx1.setText(tx1.getText().toString() + s.getType() +" 加 速度 传感器 
accelerometer" + tempString); 
break; 
case Sensor. TYPE GYROSCOPE: 
tx1.setText(bx1.getText().toString() + s.getType() + ”陀螺 仪 传感器 gyroscope" 
+ tempString); 
break; 
case Sensor.TYPE_LIGHT: 
tx1.setText(tx1.getText().toString() + s.getType() +" 环境 光线 传感器 light" 
+tempString); 
break; 
case Sensor. TYPE_MAGNETIC_FIELD: 
tx1.setText(tx1 getText().toString() + s.getType() + ”电磁 场 传感器 magnetic field" 
+ tempString); 
break; 
case Sensor. TYPE_ORIENTATION: 
tx1.setText(tx1 getText().toString() + s.getType() + ”方向 传感器 orientation" + 
tempString); 
break; 
case Sensor. TYPE PRESSURE: 
tx1.setText(tx1.getText().toString() + s.getType() + "压力 传感器 pressure" 
+ tempString); 
break; 
case Sensor. TYPE_PROXIMITY: 
tx1.setText(ix1.getText().toString() + s.getType() + ”距离 传感器 proximity" + 
tempString); 
break; 
case Sensor. TYPE AMBIENT TEMPERATURE : 
tx1.setText(tx1.getText().toString() + s.getType() +" 温度 传感器 temperature" + 
tempString); 


[OR 


break; 
default: 
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tx1.setText(tx1.getText().toString() + s.getType() +" 未 知 传感器 " + 


tempString); 
break; 
} 
} 
} 
} 
上 述 实例 代码 需要 在 真 机 中 运 4， 如 图 5-2 
所 示 。 


图 5-21 执行 效果 


53 ”光线 传感器 基础 


и 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 5 章 \ 光 线 传 感 器 基础 .avi 

在 实际 应 用 中 ， 光 线 传感器 能 够 根据 手机 所 处 环境 的 光线 来 调节 手机 屏幕 的 亮度 和 键盘 灯 。 例 如 
在 光线 充足 的 地 方 屏幕 会 很 亮 ， 键 盘 灯 就 会 关闭 。 相 反 ， 如 果 在 暗 处 ， 键 盘 灯 就 会 亮 ， 屏 幕 较 暗 《与 
屏幕 亮度 的 设置 也 有 关系 )， 这 样 既 保护 了 眼睛 ， 又 节省 了 能 量 。 光 线 传感器 在 进入 睡眠 模式 时 会 发 出 
蓝 色 周期 性 闪 动 的 光 ， 非 常 美观 。 本 节 将 详细 讲解 Android 光线 传感器 的 基本 知识 。 


5.3.1 光线 传感器 介绍 


在 外 设 项 目 开发 过 程 中 ， 光 线 传感器 通常 位 于 前 摄像 头 旁边 的 一 个 小 点 ， 如 果 在 光线 充足 的 情况 
(室外 或 者 是 灯光 充足 的 室内 ) 下 ， 在 2 一 3 秒 之 后 键盘 灯会 自动 熄灭 ， 即 使 再 操作 机 器 键盘 灯 也 不 会 
亮 ， 除 非 到 了 光线 比较 暗 的 地 方才 会 自动 亮 起 来 。 如 果 在 光线 充足 的 情况 下 用 手 将 光线 感应 器 记 上 ， 
在 2 一 3 秒 后 键盘 灯会 自动 亮 起 来 ， 在 此 过 程 中 光线 感应 器 起 到 了 一 个 节 电 的 功能 。 

要 想 在 Android 外 设 项 目 开发 过 程 中 监听 光线 传感器 ， 需 要 掌握 如 下 监听 方法 。 


(1) registerListener(SensorListenerlistener,int sensors,int rate): 已 过 时 。 


(2) registerListener(SensorListenerlistener,int sensors): 已 过 时 。 


М яа 


(3) registerListener(SensorEventListenerlistener,Sensor sensors,int rate): 监听 光线 变化 。 
(4) registerListener(SensorEventL istenerlistener Sensor sensors,int rate,Handlerhandler): 因为 SensorLis- 


tener 已 经 过 时 ， 所 以 相应 的 注册 方法 也 过 时 了 。 


在 上 述 方法 中 ， 各 个 参数 的 具体 说 明 如 下 所 示 。 


O Listener: 相应 监听 器 的 引用 ; 
口 Sensor: 相应 的 感应 器 引用 ; 


口 Rate: 感应 器 的 反应 速度 ， 这 个 必须 是 系统 提供 的 4 个 常量 之 一 。 


+ SENSOR DELAY NORMAL: 


匹配 屏幕 方向 的 变化 。 


+ SENSOR DELAY UI: 匹配 用 户 接口 。 
+ SENSOR DELAY GAME: 匹配 游戏 。 


+ SENSOR DELAY FASTEST.: 


匹配 所 能 达到 的 最 快 。 


开发 光线 传感器 应 用 时 需要 监测 SENSOR_LIGHT， 例 如 下 面 的 代码 。 


private SensorListener mySensorListener = new SensorListener(){ 


@Override 
public void onAccuracyChanged(int sensor, int accuracy) { } / 重 写 onAccuracyChanged()75;& 
@Override 
public void onSensorChanged(int sensor, float[ ] values) ( / 重 写 onSensorChanged() 方 法 
if(sensor == SensorManager.SENSOR_LIGHT){ /只 检查 光 强 度 的 变化 
myTextView1.setText(" 光 的 强度 为 : "+values[0]); // 将 光 的 强度 显示 到 TextView 
5 
} 
y 
@Override 
protected void onResume() ( / 重 写 的 onResume( 广 法 
mySensorManagerregisterListener( /注册 监听 
mySensorListener, /监听 器 SensorListener WR 
SensorManager.SENSOR LIGHT, /传感器 的 类 型 为 光 的 强度 
SensorManager.SENSOR DELAY UI [ES 
X 
super.onResume(); 
} 


在 上 述 代 码 中 ， 通 过 证 语 句 判断 是 否 为 光 的 强度 改变 事件 。 在 代码 中 只 对 光 强 度 改 变 事件 进行 处 


理 ， 将 得 到 的 光 强 度 显 示 在 屏幕 中 。 光 线 传感器 只 得 到 一 个 数据 ， 而 并 不 像 其 他 传感器 那样 得 到 的 是 
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向 上 的 分 量 。 


在 注册 监听 时 ， 通 过 传 入 SensorManager.SENSOR_LIGHT 来 通知 系统 只 注册 光线 传感器 。 
5.32 ”使 用 光线 传感器 的 方法 


在 Android 外 设 项 目 开发 过 程 中 ， 使 用 光线 传感器 的 基本 流程 如 下 。 
(1) 通过 一 个 SensorManager 来 管理 各 种 感应 器 ， 要 想 获得 这 个 管理 器 的 引用 ， 必 须 通过 如 下 所 


示 的 代码 来 实现 。 


(SensorManager)getSystemService(Context.SENSOR SERVICE); 


(2) 在 Android 系统 中 ， 所 有 的 感应 器 都 属于 Sensor 类 的 一 个 实例 ， 并 没有 继续 细 分 下 去 ， 所 以 
Android 对 于 感应 器 的 处 理 几 乎 是 一 模 一 样 的 。 既 然 都 是 Sensor 类 ， 那 么 怎么 获得 相应 的 感应 器 呢 ? 
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这 时 就 需要 通过 SensorManager 来 获得 ， 可 以 通过 如 下 所 示 的 代码 来 确定 要 获得 的 感应 器 类 型 。 

sensorManager.getDefaultSensor(Sensor.TYPE_LIGHT); 

通过 上 述 代 码 获得 了 光线 感应 器 的 引用 。 

(3) 在 获得 相应 的 传感器 的 引用 后 可 以 来 感应 光线 强度 的 变化 ， 此 时 需要 通过 监听 传感器 的 方式 
来 获得 变化 ， 监 听 功 能 通过 前 面 介绍 的 监听 方法 实现 。Android 提供 了 两 个 监听 方式 ， 一 个 是 
SensorEventListener， 另 一 个 是 SensorListener， 后 者 已 经 在 Android АРІ 上 显示 过 时 了 。 

(4) 在 Android 中 注册 传感器 后 ， 此 时 就 说 明 启 用 了 传感器 。 使 用 感应 器 是 相当 耗 电 的 ， 这 也 是 
为 什么 传感器 的 应 用 没有 那么 广泛 的 主要 原因 ， 所 以 必须 在 不 需要 的 时 候 及 时 关 掉 。 在 Android 中 通 
过 如 下 注销 方法 来 关闭 。 

О unregisterListener(SensorEventListenerlistener); 

О unregisterListener(SensorEventListenerlistener,Sensor sensor); 

(5) 使 用 SensorEventListener 来 具体 实现 ， 在 Android 外 设 项 目 开 发 过 程 中 有 如 下 两 种 实现 这 个 
监听 器 的 方法 。 

口 onAccuracyChanged(Sensor sensor, int accuracy): 是 反映 速度 变化 的 方法 ， 也 就 是 rate 变 化 时 的 

Jk. 

口 onSensorChanged(SensorEvent event): 是 传感器 的 值 变化 的 相应 的 方法 。 

读者 需要 注意 的 是 ， 上 述 两 个 方法 会 同时 响应 。 也 就 是 说 ， 当 感应 器 发 生变 化 时 ， 这 两 个 方法 会 
一 起 被 调用 。 上 述 方法 中 的 accuracy 的 值 是 4 个 常量 ， 对 应 的 整数 如 下 。 

Q SENSOR DELAY NORMAL: 3. 

О SENSOR DELAY UI: 2. 

О SENSOR DELAY GAME: 1. 

О SENSOR DELAY FASTEST: 0. 

而 类 SensorEvent 有 4 个 成 员 变量 ， 具 体 说 明 如 下 。 

口 Accuracy: 精确 值 。 

口 Sensor: 发 生变 化 的 感应 器 。 

O Timestamp: 发 生 的 时 间 ， 单 位 是 纳 秒 。 

O Values: 发 生变 化 后 的 值 ， 这 个 是 一 个 长 度 为 3 的 数组 。 

光线 传感器 只 需要 values[0] 的 值 ， 其 他 两 个 都 为 0， 而 values[0] 就 是 开发 光线 传感器 所 需要 的 ， 单 
位 是 lux 照度 单位 。 
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GEM 知识 点 讲解 ， 光盘: 视频 \ 知 识 点 \ 第 5 章 \ 磁 场 传感器 详解 .avi 

在 实际 应 用 中 ,经常 需要 检测 Android 设备 的 方向 , 例如 设备 的 朝向 和 移动 方向 。 在 Android 系统 
rB, 通常 使 用 重力 传感器 、 加 速度 传感器 、 磁 场 传感器 和 旋转 矢量 传感器 来 检测 设备 的 方向 。 本 节 将 
详细 讲解 在 Android 设备 中 使 用 磁场 传感器 检测 设备 方向 的 基本 知识 。 


w 


П And BER RE 


541 什么 是 磁场 传感器 


磁场 传感器 是 可 以 将 各 种 磁场 及 其 变化 的 量 转变 成 电信 号 输出 的 装置 。 自 然 界 和 人 类 社会 生活 的 
许多 地 方 都 存在 磁场 或 与 磁场 相关 的 信息 。 磁场 传感器 是 利用 人 工 设置 的 永久 磁体 产生 的 磁场 ， 可 以 
作为 许多 种 信息 的 载体 ， 被 广泛 用 于 探测 、 采 集 、 存 储 、 转 换 、 复 现 和 监控 各 种 磁场 和 磁场 中 承载 的 
各 种 信息 的 任务 。 在 当今 的 信息 社会 中 ， 磁 场 传感器 已 成 为 信息 技术 和 信息 产业 中 不 可 缺少 的 基础 元 
件 。 目 前 ， 人 们 已 研制 出 利用 各 种 物理 、 化 学 和 生物 效应 的 磁场 传感器 ， 并 已 在 科研 、 生 产 和 社会 生 
活 的 各 个 方面 得 到 广泛 应 用 ， 承 担 起 探究 种 种 信息 的 任务 。 

在 现实 市 面 中 ， 最 早 磁场 传感器 是 伴随 测 磁 仪 器 的 进步 而 逐步 发 展 的 。 在 众多 的 测试 磁场 方法 中 ， 
大 多 都 是 将 磁场 信息 变 成 电信 号 进行 测量 。 在 测 磁 仪器 中 “探头 ”或 “取样 装置 ”就 是 磁场 传感器 。 
随 着 信息 产业 、 工 业 自 动 化 、 交 通 运输 、 电 力 电子 技 术 、 办 公 自动 化 、 家 用 电器 、 医 疗 仪器 等 的 飞速 
发 展 和 电子 计算 机 应 用 的 普及 ， 需 用 大 量 的 传感器 将 需 进 行 测量 和 控制 的 非 电 参 量 ， 转 换 成 可 与 计算 
机 兼容 的 信号 ， 作 为 它们 的 输入 信号 ， 这 就 给 磁场 传感器 的 快速 发 展 提供 了 机 会 ， 形 成 了 相当 可 观 的 
磁场 传感器 产业 。 


5.4.2 ”磁场 传感器 的 分 类 


在 现实 应 用 中 ， 磁 场 传 感 器 的 主要 分 类 如 下 。 

(1) 薄膜 磁 致 电阻 传感器 

铁 磁性 物质 在 磁化 过 程 中 ， 它 的 电阻 值 沿 磁化 方向 将 增加 ， 并 达到 饱和 的 现象 称 为 磁 阻 效应 。 薄 
膜 磁 阻 元 件 是 利用 薄膜 工艺 和 微细 加 工 技术 ， 将 NiPe/NiCo 合金 用 真空 蒸 镇 或 溯 射 工艺 沉积 到 硅 片 或 
铁 氧 体 基 片上 ， 通 过 微细 加 工 技术 制 成 一 定形 状 的 磁 咀 图 形 ， 形 成 三 端 式 、 四 端 式 以 及 多 端 式 器 件 。 
BMber 结构 桥 式 电路 磁 阻 元 件 具有 灵敏 度 高 、 工 作 频率 特性 好 、 温 度 稳 定性 好 、 结 构 简 单 、 体 积 小 等 
特点 ， 可 制 成 高 密度 磁 咀 磁头 、 磁 性 编码 器 、 磁 阻 位移 传 感 器 、 磁 阻 电流 传感器 等 。 

(2) 磁 阻 敏感 器 

物质 在 磁场 中 电阻 发 生变 化 的 现象 称 为 磁 阻 效应 。 对 于 铁 、 钻 、 镍 及 其 合金 等 强 磁 性 金属 ， 当 外 
加 磁场 平行 于 磁体 内 部 磁化 方向 时 ， 电 阻 几乎 不 随 外 加 磁场 变化 ， 当 外 加 磁场 偏离 金属 的 内 磁化 方向 
时 ， 此 类 金属 的 电阻 值 将 减 小 ， 这 就 是 强 磁 金属 的 各 向 异性 磁 阻 效应 。 

G) 电 涡 流 式 传感器 

近年 来 ， 国 内 外 正 发 展 一 对 建立 在 电 涡流 效应 原理 上 的 传感器 ， 即 电 涡流 式 传感器 。 这 种 传感器 
不 但 具有 测量 线性 范围 大 、 灵 敏 度 高 、 结 构 简 单 、 抗 干扰 能 力 强 、 不 受 油污 等 介质 的 影响 等 优点 ， 而 
且 又 具有 无 损 、 非 接触 测量 的 特点 ， 目 前 正 广泛 地 应 用 于 工业 各 部 门 中 的 位 移 、 尺 寸 、 厚 度 、 振 动 、 
转速 、 压 力 、 电 导 率 、 温 度 、 波 面 等 测量 ， 以 及 探测 金属 材料 和 加 工件 表面 裂纹 及 缺陷 。 

(4) 磁性 液体 加 速度 传感器 

磁性 液体 作为 一 种 新 型 的 纳米 功能 材料 ， 一 经 问世 便 走 到 科学 技术 发 展 的 前 沿 ， 目 前 科学 家 们 已 
经 将 这 种 新 型 功能 材料 应 用 到 广阔 的 领域 中 。 以 此 为 基础 的 磁性 液体 传感器 技术 也 引起 了 国际 技术 领 
域 广泛 的 关注 。 

(5) 磁性 液体 水 平 传感器 

磁性 液体 传感器 的 研究 与 应 用 起 源 于 美国 。 早 在 1983 年 美国 新 墨西哥 州 阿 尔 帕克 基 应 用 技术 公司 
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就 与 美国 空军 签订 了 合同 ， 美 国 新 墨西哥 州 阿尔 帕克 基 应 用 技术 公司 便 开始 研制 基于 磁性 液体 动力 学 
原理 (MHD) 的 主动 式 和 被 动 式 传感器 。 磁 性 液体 传感器 应 用 领域 很 广 ， 既 可 以 应 用 到 民用 上 ， 也 可 
以 应 用 到 军工 上 ， 有 其 他 传感器 所 代 蔡 不 了 的 功能 ， 正 因 如 此 ， 国 外 比较 早 地 意识 到 开发 磁性 液体 传 
感 器 的 意义 ， 并 且 已 开始 了 研究 和 生产 ， 并 将 该 种 传感器 应 用 到 航空 、 航 天 、 宇 航 站 等 尖端 军事 领域 。 
美国 、 法 国 、 德 国 、 俄 罗斯 、 日 本 和 罗马 尼 亚 等 国家 已 开始 利用 磁性 液体 制作 各 种 传感器 。 磁 性 液体 
水 平 传感器 对 控制 机 器 人 工作 状态 ， 使 太阳 能 栅 板 保持 朝向 太阳 ， 使 抛物 天 线 持续 朝向 通信 系统 中 的 
人 造 卫 星 等 方面 有 着 重要 的 应 用 。 目 前 国外 已 研制 出 单 轴 、 双 轴 、 三 轴 等 类 型 的 磁性 液体 水 平 传感器 ， 
而 我 国有 关 磁 性 液体 传感器 的 研究 尚 处 于 实验 和 探索 阶段 。 


5.4.3 Android 系统 中 的 磁场 传感器 


在 Android 系统 中 ， 磁 场 传感器 ТҮРЕ MAGNETIC FIELD， 单位 是 nbT〈 微 特 斯 拉 )， 能 够 测量 设 
备 周 围 3 个 物理 轴 (x, y, 2) 的 磁场 。 在 Android 设备 中 ， 磁 场 传感器 主要 用 于 感应 周围 的 磁感应 强 
度 ， 在 注册 监听 器 后 主要 用 于 捕获 如 下 3 个 参数 : 

ПШ values[0] 

О values[l] 

口 values[2] 

ER 3 个 参数 分 别 代表 磁感应 强度 在 空间 坐标 系 中 3 个 方向 轴 上 的 分 量 。 所 有 数据 的 单位 为 4T， 
即 微 特 斯 拉 。 

在 Android 系统 中 ， 磁 场 传感器 主要 包含 了 如 下 公共 方法 。 

O int getFifoMaxEventCount(): 返回 该 传感器 可 以 处 理事 件 的 最 大 值 。 如 果 该 值 为 0, 表示 当前 模 
式 不 支持 此 传感器 。 
int getFifoReservedEventCount(): 保留 传感器 在 批 处 理 模 式 中 FIFO 的 事件 数 ， 给 出 了 一 个 在 保 
证 可 以 分 批 事件 的 最 小 值 。 
float веМахітитВапре(): 传感器 单元 的 最 大 范围 。 
int getMinDelay(): 最 小 延迟 。 
String getName(): 获取 传感器 的 名 称 。 
float getPower(): 获取 传感器 电量 。 
float getResolution(): 获得 传感器 的 分 辨 率 。 
int getType(): 获取 传感器 的 类 型 。 
String getVendor(): 获取 传感器 的 供应 商 字 符 串 。 
int getVersion(): 获取 该 传感器 模块 版 本 。 
String toString(): 返回 一 个 对 当前 传感器 的 字符 串 描述 。 


口 
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И 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 5 章 \ 加 速度 传感器 详解 .avi 
在 现实 应 用 中 ， 加 速度 传感器 可 以 帮助 机 器 人 了 解 它 现 在 身 处 的 环境 ， 能 够 分 辨 出 是 在 登山 还 是 
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用 来 分 析 发 动机 的 振动 。 本 节 将 简要 讲解 Android 系统 中 加 速度 传感器 的 基础 性 知识 。 


5.5.1 加 速度 传感器 的 分 类 


在 实际 应 用 过 程 中 ， 可 以 将 加 速度 传感器 分 为 如 下 4 类 。 

(1) 压 电 式 

压 电 式 加 速度 传感器 又 称 压 电 加 速度 计 。 它 也 属于 惯性 式 传感器 。 压 电 式 加 速度 传感器 的 原理 是 
利用 压 电 陶瓷 或 石英 晶体 的 压 电 效应 ， 在 加 速度 计 受 振 时 ， 质 量 块 加 在 压 电 元 件 上 的 力也 随 之 变化 。 
当 被 测 振动 频率 远 低 于 加 速度 计 的 固有 频率 时 ， 则 力 的 变化 与 被 测 加 速度 成 正比 。 

(2) 压 阻 式 

基于 世界 领先 的 MEMS 硅 微 加 工 技术 ， 压 阻 式 加 速度 传感器 具有 体积 小 、 低 功 耗 等 特点 ， 易 于 
集成 在 各 种 模拟 和 数字 电路 中 ， 广 泛 应 用 于 汽车 碰撞 实验 、 测 试 仪器 、 设 备 振动 监测 等 领域 。 加 速 
度 传感器 网 为 客户 提供 压 阻 式 加 速度 传感器 / 压 阻 加 速度 计 各 品牌 的 型 号 、 参 数 、 原 理 、 价 格 、 接 线 
图 等 信息 。 

(3) 电容 式 

电容 式 加 速度 传感器 是 基于 电容 原理 的 极 距 变 化 型 的 电容 传感器 。 电 容 式 加 速度 传感器 /电容 式 加 
速度 计 是 对 比较 通用 的 加 速度 传感器 ， 在 某 些 领 域 无 可 替代 ， 如 安全 气囊 和 手机 移动 设备 等 。 电 容 式 
加 速度 传感器 /电容 式 加 速度 计 采 用 了 微机 电 系统 (MEMS) 工艺 ， 在 大 量 生产 时 变 得 经 济 ， 从 而 保证 
了 较 低 的 成 本 。 

(4) 伺服 式 

伺服 式 加 速度 传感器 是 一 种 闭环 测试 系统 ， 具 有 动态 性 能 好 、 动 态 范围 大 和 线性 度 好 等 特点 。 其 
工作 原理 是 ， 传 感 器 的 振动 系统 由 m-k 系统 组 成 ， 与 一 般 加 速度 计 相 同 ， 但 质量 m 上 还 接着 一 个 电磁 
线圈 ， 当 基 座 上 有 加 速度 输入 时 ， 质 量 块 偏离 平衡 位 置 ， 该 位 移 大 小 由 位 移 传感器 检测 出 来 ， 经 伺服 
放大 器 放大 后 转换 为 电流 输出 ， 该 电流 流 过 电磁 线圈 ， 在 永久 磁铁 的 磁场 中 产生 电磁 恢复 力 ， 力 图 使 
质量 块 保持 在 仪表 壳 体 中 原来 的 平衡 位 置 上 ， 所 以 伺服 加 速度 传感器 在 闭环 状态 下 工作 。 由 于 有 反馈 
作用 ， 增 强 了 抗 干扰 的 能 力 ， 提 高 测量 精度 ， 扩 大 了 测量 范围 ， 伺 服 加 速度 测量 技术 广泛 地 应 用 于 惯 
性 导航 和 惯性 制导 系统 中 ， 在 高 精度 的 振动 测量 和 标定 中 也 有 应 用 。 


5.5.2 ”加 速度 传感器 的 主要 应 用 领域 


在 计算 机 领域 中 ， 加 速度 传感器 可 以 测量 牵引 力 产 生 的 加 速度 。 例 如 在 IBM Thinkpad 笔记 本 电脑 
中 就 内 置 了 加 速度 传感器 ， 能 够 动态 地 监测 出 笔记 本 在 使 用 中 的 振动 。 根 据 这 些 振动 数据 ， 系 统 会 智 
能 地 选择 关闭 硬盘 还 是 让 其 继续 运行 ， 这 样 可 以 最 大 程度 地 保护 由 于 振动 而 引发 的 硬件 损坏 问题 。 所 
以 ， 加 速度 传感器 主要 应 用 在 手柄 振动 /摇晃 、 仪 器 仪表 、 汽 车 制 动 启动 、 地 震 、 报 警 系统 、 玩 具 、 结 
构 物 、 环 境 监 视 、 工 程 测 振 、 地 质 勘 探 、 铁 路 、 桥 梁 、 大 坝 的 振动 测试 与 分 析 ， 还 有 和 鼠标， 高 层 建 筑 结 
构 动态 特性 和 安全 保卫 振动 侦察 方面 。 在 接 下 来 的 内 容 中 ， 将 详细 讲解 加 速度 传感器 的 主要 应 用 领域 。 

(1) 汽车 安全 

加 速度 传感器 主要 用 于 汽车 安全 气囊 、 防 抱 死 系统 、 牵 引 控制 系统 等 安全 性 能 方面 。 在 汽车 安全 
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应 用 中 ， 加 速度 计 的 快速 反应 非常 重要 。 安 全 气囊 应 在 什么 时 候 弹出 要 迅速 确定 ， 所 以 加 速度 计 必 须 
在 瞬间 作出 反应 。 通 过 采用 可 迅速 达到 稳定 状态 而 不 是 振动 不 止 的 传感器 设计 可 以 缩短 器 件 的 反应 时 
间 。 其 中 ， 压 阻 式 加 速度 传感器 由 于 在 汽车 工业 中 的 广泛 应 用 而 发 展 最 快 。 

(2) 游戏 控制 

加 速度 传感器 可 以 检测 上 下 左右 的 倾角 变化 ， 因 此 通过 前 后 倾斜 手持 设备 来 实现 对 游戏 中 物体 的 
前 后 左右 的 方向 控制 ， 就 变 得 很 简单 了 。 

(3) 图 像 自动 翻转 

用 加 速度 传感器 检测 手持 设备 的 旋转 动作 及 方向 ， 实 现 所 要 显示 图 像 的 转正 。 

(4) 电子 指南 针 倾斜 校正 

磁 传感器 是 通过 测量 磁 通 量 的 大 小 来 确定 方向 的 。 当 磁 传 感 器 发 生 倾 斜 时 ， 通 过 磁 传 感 器 的 地 磁 
通 量 将 发 生变 化 ， 从 而 使 方向 指向 产生 误差 。 因 此 ， 如 果 不 带 倾斜 校正 的 电子 指南 针 ， 需 要 用 户 水 平 
放置 。 而 利用 加 速度 传感器 可 以 测量 倾角 的 这 一 原理 ， 可 以 对 电子 指南 针 的 倾斜 进行 补偿 。 

(5) GPS 导航 系统 死角 的 补偿 

GPS 系统 是 通过 接收 三 颗 呈 120° 分 布 的 卫星 信号 来 最 终 确定 物体 的 方位 的 。 在 一 些 特殊 的 场合 和 地 貌 ， 
如 隧道 、 高 楼 林立 、 从 林地 带 ，GPS 信号 会 变 弱 甚 至 完全 消失 ， 这 也 就 是 所 谓 的 死角 。 而 通过 加 装 加 
速度 传感器 及 以 前 我 们 所 通用 的 惯性 导航 ， 便 可 以 进行 系统 死 区 的 测量 。 对 加 速度 传感器 进行 一 次 积 
分 ， 就 变 成 了 单位 时 间 里 的 速度 变化 量 ， 从 而 测 出 在 死 区 内 物体 的 移动 。 

(6) 计 步 器 功能 

加 速度 传感器 可 以 检测 交流 信号 以 及 物体 的 振动 ， 人 在 走动 的 时 候 会 产生 一 定 规律 性 的 振动 ， 而 
加 速度 传感器 可 以 检测 振动 的 过 零点 ， 从 而 计算 出 人 所 走 的 步 数 或 跑步 所 跑 的 步 数 ， 从 而 计算 出 人 所 
移动 的 位 移 ， 并 且 利用 一 定 的 公式 可 以 计算 出 卡路里 的 消耗 。 

CD. 防 手 抖 功能 

用 加 速度 传感器 检测 手持 设备 的 振动 /晃动 幅度 ， 当 振动 /晃动 幅度 过 大 时 锁 住 照 相 快 门 ， 使 所 拍摄 
的 图 像 永 远 是 清晰 的 。 

(8) 闪 信 功能 

通过 挥动 手持 设备 实现 在 空中 显示 文字 ， 用 户 可 以 自己 编写 显示 的 文字 。 这 个 闪 信 功能 是 利用 人 
们 的 视觉 残留 现象 ， 用 加 速度 传感器 检测 挥动 的 周期 ， 实 现 所 显示 文字 的 准确 定位 。 

(9) 硬盘 保护 

利用 加 速度 传感器 检测 自由 落体 状态 ， 从 而 对 迷你 硬盘 实施 必要 的 保护 。 大 家 知道 ， 硬 盘 在 读 取 
数据 时 ， 磁 头 与 碟 片 之 间 的 间距 很 小 ， 因 此 ， 外 界 的 轻微 振动 就 会 对 硬盘 产生 很 坏 的 后 果 ， 使 数据 丢 
失 ， 而 利用 加 速度 传感器 可 以 检测 自由 落体 状态 。 当 检测 到 自由 落体 状态 时 ， 让 磁头 复位 ， 以 减少 硬 
盘 的 受 损 程度 。 

(10) 设备 或 终端 姿态 检测 

加 速度 传感器 和 陀螺 仪 通常 称 为 惯性 传感器 ， 常 用 于 各 种 设备 或 终端 中 实现 姿态 检测 、 运 动 检测 
等 ， 很 适合 玩 体感 游戏 的 人 群 。 加 速度 传感器 利用 重力 加 速度 ， 可 以 用 于 检测 设备 的 倾斜 角度 ， 但 是 
它 会 受到 运动 加 速度 的 影响 ， 使 倾角 测量 不 够 准确 ， 所 以 通常 需 利 用 陀螺 仪 和 磁 传 感 器 补偿 。 同 时 磁 
传感器 测量 方位 角 时 ， 也 是 利用 地 磁场 ， 当 系统 中 电流 变化 或 周围 有 导 磁 材料 时 ， 以 及 当 设 备 倾斜 时 ， 
测量 出 的 方位 角 也 不 准确 ， 这 时 需要 用 加 速度 传感器 (倾角 传感器 ) 和 陀螺 仪 进行 补偿 。 
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(11) 智能 产品 

加 速度 传感器 在 微 信 功 能 中 的 创新 功能 突破 了 电子 产品 的 千篇一律 ， 这 个 功能 的 实现 来 源 于 传 感 
器 的 方向 、 加 速 表 、 光 线 、 磁 场 、 临 近 性 、 温 度 等 参数 的 特性 。 这 个 原理 是 手机 里 面 集成 的 加 速度 传 
感 器 ， 它 能 够 分 别 测量 X、Y、Z 三 个 方面 的 加 速度 值 ，X 方向 值 的 大 小 代表 手机 水 平移 动 ，Y 方向 值 
的 大 小 代表 手机 垂直 移动 ，Z 方向 值 的 大 小 代表 手机 的 空间 垂直 方向 ， 天 空 的 方向 为 正 ， 地 球 的 方向 
为 负 ， 然 后 把 相关 的 加 速度 值 传输 给 操作 系统 ， 通 过 判断 其 大 小 变化 ， 就 能 知道 同时 玩 微 信 的 朋友 。 


5.5.3 ”线性 加 速度 传感器 的 原理 


线性 加 速度 传感器 是 加 速度 传感器 的 一 种 ， 分 开 单独 讲 的 原因 是 为 了 和 陀螺 仪 传感器 区 分 开 。 陀 
螺 仪 是 测 角 速度 的 ， 加 速度 是 测 线性 加 速度 的 。 其 中 前 者 利用 了 惯性 原理 ， 而 后 者 利用 了 力 平衡 原理 。 


线性 加 速度 传感器 利用 了 惯性 原理 : 
A (加 速度 ) =F (惯性 力 ) IM (йш) 


我 们 只 需要 测量 Е 即 可 。 怎 么 测量 F? 是 要 电磁 力 去 平衡 这 个 力 就 可 以 得 到 下 对 应 于 电流 的 关系 ， 
只 需要 用 实验 去 标定 这 个 比例 系数 就 行 了 。 多 数 加 速度 传感器 是 根据 压 电 效应 的 原理 来 工作 的 。 所 谓 
的 压 电 效应 就 是 “对 于 不 存在 对 称 中 心 的 异 极 晶体 加 在 晶体 上 的 外 力 除了 使 晶体 发 生 形变 以 外 ， 还 将 
改变 晶体 的 极 化 状态 ， 在 晶体 内 部 建立 电场 ， 这 种 由 于 机 械 力作 用 使 介质 发 生 极 化 的 现象 称 为 正 压 电 
效应 ”。 

一 般 加 速度 传感器 就 是 利用 了 其 内 部 的 由 于 加 速度 造成 的 晶体 变形 这 个 特性 。 由 于 这 个 变形 会 产 
生 电 压 ， 只 要 计算 出 产生 电压 和 所 施加 的 加 速度 之 间 的 关系 ， 就 可 以 将 加 速度 转化 成 电压 输出 。 当 然 ， 
还 有 很 多 其 他 方法 来 制作 加 速度 传感器 ， 比 如 压 阻 技术 、 电 容 效 应 、 热 气泡 效应 、 光 效应 ， 但 是 其 最 
基本 的 原理 都 是 由 于 加 速度 产生 某 个 介质 产生 变形 , 通过 测量 其 变形 量 并 用 相关 电路 转化 成 电压 输出 。 
每 种 技术 都 有 各 自 的 机 会 和 问题 。 

压 阻 式 加 速度 传感器 由 于 在 汽车 工业 中 的 广泛 应 用 而 发 展 最 快 。 由 于 安全 性 越 来 越 成 为 汽车 制造 
商 的 卖点 ， 这 种 附加 系统 也 越 来 越 多 。 根 据 有 关 调查 ， 预 计 其 市 值 将 按 年 平均 4.1% 速 度 增长 ， 这 其 中 
欧洲 市 场 的 速度 最 快 ， 因 为 欧洲 是 许多 安全 气 圳 和 汽车 生产 企业 的 所 在 地 。 

压 电 技 术 主 要 在 工业 上 用 来 防止 机 器 故障 ， 使 用 这 种 传感器 可 以 检测 机 器 潜在 的 故障 以 达到 自 保 
护 ， 及 避免 对 工人 产生 意外 伤害 ， 这 种 传感器 具有 用 户 尤 其 是 质量 行业 的 用 户 所 追求 的 可 重复 性 、 稳 
定性 和 自生 性 。 但 是 在 许多 新 的 应 用 领域 ， 很 多 用 户 尚 无 使 用 这 类 传感器 的 意识 ， 销 售 商 冒险 进入 这 
种 尚 待 开 发 的 市 场 会 麻烦 多 多 ， 因 为 终端 用 户 对 由 于 使 用 这 种 传感器 而 带 来 的 问题 和 解决 方法 都 认识 
不 多 。 如 果 这 些 问题 能 够 得 到 解决 ， 将 会 促进 压 电 传感器 得 到 更 快 的 发 展 。 

使 用 加 速度 传感器 有 时 会 碰 到 低频 场合 测量 时 输出 信号 出 现 失真 的 情况 ， 用 多 种 测量 判断 方法 一 
时 找 不 出 故障 出 现 的 原因 ， 经 过 分 析 总 结 ， 导 致 测量 结果 失真 的 因素 主要 是 : 系统 低频 响应 差 、 系 统 
低频 信 噪 比 差 、 外 界 环境 对 测量 信号 的 影响 。 所 以 ， 只 要 出 现 加 速度 传感器 低频 测量 信号 失真 情况 ， 
对 比 以 上 3 点 看 看 是 哪个 因素 造成 的 ， 有 针对 性 地 去 解决 。 

在 Android 系统 中 ,线性 加 速度 传感器 的 类 型 是 TYPE. LINEAR. ACCELERATION, 单位 是 m/s? , 
能 够 获取 加 速度 传感器 去 除 重力 的 影响 得 到 的 数据 。 
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5.54 Android 系统 中 的 加 速度 传感器 


在 Android 系统 中 ， 加 速度 传感器 是 TYPE_ACCELEROMETER， 单 位 是 m/s* ， 能 够 测量 应 用 于 
设备 X、Y、Z 轴 上 的 加 速度 ， 又 叫做 G-sensor。 在 开发 过 程 中 ， 通 过 Android 的 加 速度 传感器 可 以 取 
fX. Y. Z 三 个 轴 的 加 速度 。 在 Android 系统 中 ， 在 类 SensorManager 中 定义 了 很 多 星体 的 重力 加 速 
度 值 ， 如 表 5-1 所 示 。 


表 5-1 类 SensorManager 被 定义 的 各 新 星体 的 重力 加 速度 值 


常量 名 实际 的 值 
GRAVITY DEATH STAR 1 3.5303614Е-7 
GRAVITY_EARTH 地 球 9.80665 
GRAVITY JUPITER 23.12 
GRAVITY MARS KE 3.71 
GRAVITY MERCURY 3.7 
GRAVITY_MOON 1.6 
GRAVITY_NEPTUNE 12.0 
GRAVITY PLUTO 0.6 
GRAVITY SATURN 8.96 
GRAVITY_SUN 275.0 
GRAVITY THE ISLAND 4.815162 
GRAVITY_URANUS 8.69 
GRAVITY_VENUS 8.87 


通常 来 说 ， 从 加 速度 传感器 获取 的 值 ， 拿 手机 等 智能 设备 的 人 的 手 震动 或 放 在 摇晃 的 场所 的 时 候 ， 
受 震 动 影 响 设备 的 值 增幅 变化 是 存在 的 。 手 的 摇动 、 轻 微 震动 的 影响 是 属于 长 波形 式 ， 去 掉 这 种 长 波 
干扰 的 影响 ， 可 以 取得 高 精度 的 值 。 去 掉 这 种 长 波 的 过 滤 机 能 叫 Low-Pass Filter。Low-Pass Filter 机 制 
有 如 下 3 种 封装 方法 。 

口 从 抽样 数据 中 取得 中 间 的 值 的 方法 。 

口 最 近 取 得 的 加 速度 的 值 每 个 很 少 变化 的 方法 。 

口 从 抽样 数据 中 取得 中 间 的 值 的 方法 。 

在 Android 应 用 中 ， 有 时 需要 获取 瞬间 加 速度 值 ， 例 如 类 似 计 步 器 、 作 用 力 测定 的 应 用 开发 的 时 
候 ， 如 果 想 检测 出 加 速度 急剧 的 变化 。 此 时 的 处 理 和 Low-Pass Filter 处 理 相反 ， 需 要 去 掉 短 周波 的 影 
响 ， 这 样 可 以 取得 数据 。 像 这 种 去 掉 短 周波 的 影响 的 过 滤器 叫做 High-pass Filter. 


56 方向 传感器 详解 


GE 知识 点 讲解 : 光盘: 视频 \ 知 识 点 \ 第 5 章 \ 方 向 传感器 详解 .avi 

在 Android 设备 中 ， 经 常 需要 检测 设备 的 方向 ， 例 如 设备 的 朝向 和 移动 方向 。 在 Android 系统 中 ， 通 
常 使 用 重力 传感器 、 加 速度 传感器 、 磁 场 传感器 和 旋转 矢量 传感器 来 检测 设备 的 方向 。 本 节 内 容 将 详细 讲 
解 在 Android 设备 中 使 用 方向 传感器 检测 设备 方向 的 基本 知识 ， 为 读者 学 习 本 书后 面 的 知识 打下 基础 。 
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5.6.1 方向 传感器 基础 


在 现实 世界 中 ， 方 向 传感器 通过 对 力 敏感 的 传感器 ， 感 受 手机 等 设备 在 变换 姿势 时 的 重心 变化 ， 
使 手机 等 设备 光标 变化 位 置 从 而 实现 选择 的 功能 。 方 向 传感器 运用 了 欧 拉 角 的 知识 ， 欧 拉 角 的 基本 思 
想 是 将 角 位 移 分 解 为 绕 3 个 互相 垂直 轴 的 3 个 旋转 组 成 的 序列 。 其 实 ， 任 意 3 个 轴 和 任意 顺序 都 可 以 ， 
但 最 有 意义 的 是 使 用 笛 卡 儿 坐标 系 并 按 一 定 的 顺序 所 组 成 的 旋转 序列 。 

在 学 习 欧 拉 角 知识 之 前 先 介绍 几 种 不 同 概念 的 坐标 系 ， 以 便于 读者 理解 欧 拉 角 知 识 。 

(1) 世界 坐标 系 

世界 坐标 系 是 一 个 特殊 的 坐标 系 ， 建 立 了 描述 其 他 坐标 系 所 需要 的 参考 框架 。 能 够 用 世界 坐标 系 
描述 其 他 坐标 系 的 位 置 ， 而 不 能 用 更 大 的 、 外 部 的 坐标 系 来 描述 世界 坐标 系 。 例如,“ 向 西 "“ 向 东 ” 
等 词汇 就 是 世界 坐标 系 中 的 描述 词汇 。 

(2) 物体 坐标 系 

物体 坐标 系 是 和 特定 物体 相关 联 的 坐标 系 ， 每 个 物体 都 有 它们 独立 的 坐标 系 。 当 物体 移动 或 改变 
方向 时 ， 和 该 物体 相关 联 的 坐标 系 将 随 之 移动 或 改变 方向 。 例 如 ,“ 向 左 ”“ 向 右 ” 等 词汇 就 是 物体 坐 
标 系 中 的 描述 词汇 。 

(3) 摄像 机 坐标 系 

摄像 机 坐标 系 是 和 观察 者 密切 相关 的 坐标 系 。 在 摄像 机 坐标 系 中 ， 摄 像 机 在 原点 ，x 轴 向 右 ，z 轴 
向 前 〈 朝 向 屏幕 内 或 摄像 机 方向 )，y 轴 向 上 不 是 世界 的 上 方 而 是 摄像 机 本 身 的 上 方 )。 

(4) 惯性 坐标 系 

惯性 坐标 系 是 为 了 简化 世界 坐标 系 到 物体 坐标 系 的 转换 而 引入 的 一 种 新 的 坐标 系 。 惯 性 坐标 系 的 
原点 和 物体 坐标 系 的 原点 重合 ， 但 惯性 坐标 系 的 轴 平 行 于 世界 坐标 系 的 轴 。 

在 欧 拉 角 中 ， 表 示 一 个 物体 的 方位 用 “Yaw-Pitch-Roll” 约 定 。 在 这 个 系统 中 ， 一 个 方位 被 定义 为 
一 个 Yaw 角 、 一 个 Pitch 角 和 一 个 Roll 角 。 欧 拉 角 的 基本 思想 是 让 物体 开始 于 “标准 ”方位 ， 目 的 是 
使 物体 坐标 轴 和 惯性 坐标 轴 对 齐 。 在 标准 方位 上 ， 让 物体 做 Yaw, Pitch 和 Roll 旋转 ， 最 后 物体 到 达 我 
们 想 要 描述 的 方位 。 

(5) Yaw 轴 

Yaw 轴 是 3 个 方向 轴 中 唯一 不 变 的 轴 ， 其 方向 总 是 竖 直 向 上 ， 和 世界 坐标 系 中 的 z 轴 是 等 同 的 
也 就 是 重力 加 速度 g 的 反方 向 。 

(6) Pitch 轴 

Pitch 轴 方 向 依赖 于 手机 沿 Yaw 轴 的 转动 情况 ， 即 当 手机 沿 Yaw 转 过 一 定 的 角度 后 ，Pitch 轴 也 相 
应 围绕 Yaw 轴 转 动 相同 的 角度 。Pitch 轴 的 位 置 依赖 于 手机 沿 Yaw 轴 转 过 的 角度 ， 好 比 Yaw 轴 和 Pitch 
轴 是 两 根 焊 死 在 一 起 成 90° 。 


5.6.2 Android 中 的 方向 传感器 


在 Android 系统 中 ， 方 向 传感器 的 类 型 是 TYPE ORIENTATION， 用 于 测量 设备 围绕 3 个 物理 轴 СХ, 
Y, Z) 的 旋转 角度 ， 在 新 版 本 中 已 经 使 用 SensorManager getOrientation() 替 代 。Android 系统 中 的 方向 
传感器 在 生活 中 的 典型 应 用 例子 是 指南 针 ， 接 下 来 先 来 简单 介绍 一 下 传感器 中 3 个 参数 X、Y、Z 的 含 
义 ， 如 图 5-22 所 示 。 
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如 图 5-22 Bras. 浅 色 部 分 表示 一 个 手机 , 带 有 小 圈 那 一 头 是 手机 头 部 ,各 个 部 分 的 具体 说 明 如 下 。 
O 传感器 中 的 X: 如 图 5-22 所 示 ， 规 定 X 正 半 轴 为 北 ， 手 机 

头 部 指向 OF 方向 , 此 时 X 的 值 为 0。 如 果 手 机 头 部 指向 0G I 

方向 ， 此 时 X 值 为 90; 指向 OH 方向 ，X 值 为 180; 指向 OE 

方向 ，X 值 为 270。 
а 传感器 中 的 Y: 现在 将 手机 沿 着 BC 轴 慢 慢 向 上 抬 起 ， 即 AEL >, 
FIATI, ME Law, ВАЈАР #]ВС 2—73 {ы 
右边 并 落 在 XOY 平 面 上 , Y 的 值 将 在 0~180 之 间 变动 , 如 РА 
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果 手 机 沿 着 AD 轴 慢 慢 向 上 抬 起 ， 即 手机 尾部 不 动 ， 直 到 

BC 跑 到 AD 左 边 并 且 落 在 XOY 平 面 上 , Y 的 值 将 在 0 一 -180 & x 

之 间 变 动 ， 这 就 是 方向 传感器 中 Y 的 含义 。 
O 传感器 中 的 Z: 现在 将 手机 沿 着 AB 轴 慢 慢 向 上 抬 起 ， 即 
手机 左边 框 不 动 ， 右 边框 慢 慢 向 上 斤 起 来 ， 直 到 CD 跑 到 AB 右 边 并 落 在 XOY 平 面 上 ，2Z 的 值 将 
从 0~180 之 间 变动 ， 如 果 手 机 沿 着 CD 轴 慢 慢 向 上 抬 起 ， 即 手机 右边 框 不 动 ， 直 到 AB 跑 到 CD 左 
边 并 且 落 在 XOY 平 面 上 ，2Z 的 值 将 在 0~-180 之 间 变 动 ， 这 就 是 方向 传感器 中 Z 的 含义 。 


图 5-22 参数 X、Y、Z 
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GEM 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 5 章 \ 陀 螺 仪 传感器 详解 .avi 

陀螺 仪 传感器 是 一 个 基于 自由 空间 移动 和 手势 的 定位 和 控制 系统 。 例 如 我 们 可 以 在 假想 的 平面 上 
移动 鼠标 ， 屏 幕 上 的 光标 就 会 随 之 跟着 移动 ， 并 且 可 以 绕 着 链接 画 圈 和 点 击 按键 。 又 比如 当 我 们 正在 
演讲 或 离开 桌子 时 ， 这 些 操作 都 能 够 很 方便 地 实现 。 陀 螺 仪 传感器 已 经 被 广泛 运用 于 手机 、 平 板 等 移 
动 便携 设备 上 ， 将 来 的 设备 也 会 陆续 使 用 陀螺 仪 传感器 。 本 节 将 详细 讲解 在 Android 设备 中 使 用 陀螺 
仪 传感器 的 基本 知识 ， 为 读者 学 习 本 书后 面 的 知识 打下 基础 。 


5.7.1 陀螺 仪 传感器 基础 


陀螺 仪 的 原理 是 ， 当 一 个 旋转 物体 的 旋转 轴 所 指 的 方向 在 不 受 外 力 影响 时 是 不 会 改变 的 。 根 据 这 
个 道理 ， 可 以 用 陀螺 仪 来 保持 方向 。 然 后 用 多 种 方法 读 取 轴 所 指示 的 方向 ， 并 自动 将 数据 信号 传 给 控 
制 系统 。 在 现实 生活 中 ， 骑 自行 车 便 是 利用 了 这 个 原理 。 轮 子 转 得 越 快 越 不 容易 倒 ， 因 为 车 轴 有 一 种 
保持 水 平 的 力量 。 现 代 陀 螺 仪 可 以 精确 地 确定 运动 物体 的 方位 ， 在 现代 航空 、 航 海 、 航 天 和 国防 工业 
中 广泛 使 用 的 一 种 惯性 导航 仪器 。 传 统 的 惯性 陀螺 仪 主要 部 分 有 机 械 式 的 陀螺 仪 ， 而 机 械 式 的 陀螺 仪 
对 工艺 结构 的 要 求 很 高 。20 世纪 70 年 代 提出 了 现代 光纤 陀螺 仪 的 基本 设想 ， 到 80 年 代 以 后 ， 光 纤 陀 
螺 仪 就 得 到 了 非常 迅速 的 发 展 ， 激 光 谐振 陀螺 仪 也 有 了 很 大 的 发 展 。 光 纤 陀螺 仪 具 有 结构 紧凑 、 灵 敏 
度 高 、 工 作 可 靠 的 特点 ， 在 很 多 的 领域 已 经 完全 取代 了 机 械 式 的 传统 的 陀螺 仪 ， 成 为 现代 导航 仪器 中 
的 关键 部 件 。 

根据 框架 的 数目 和 支承 的 形式 以 及 附件 的 性 质 进行 划分 ， 陀 螺 仪 传感器 的 主要 类 型 有 以 下 两 种 。 

(D 二 自由 度 陀 螺 仪 : 只 有 一 个 框架 ， 使 转子 自转 轴 具 有 一 个 转动 自由 度 。 根 据 二 自由 度 陀 螺 仪 
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中 所 使 用 的 反作用 力矩 的 性 质 ， 可 以 把 这 种 陀螺 仪 分 为 如 下 З 种 类 型 。 

D 积分 陀螺 仪 〈 它 使 用 的 反作用 力矩 是 阻尼 力矩 ) 。 

口 速率 陀螺 仪 ( 它 使 用 的 反作用 力矩 是 弹性 力矩 ) 。 

о 无 约束 陀螺 仪 〈 它 仅 有 惯性 反作用 力矩 ) 。 

另外 ， 除 了 机 、 电 框架 式 陀 螺 仪 外 还 出 现 了 某 些 新 型 陀螺 仪 ， 例 如 静电 式 自由 转子 陀螺 仪 、 挠 性 
陀螺 仪 和 激光 陀螺 仪 等 。 

(2) 三 自由 度 陀螺 仪 : 具有 内 、 外 两 个 框架 ， 使 转子 自转 轴 具 有 两 个 转动 自由 度 。 在 没有 任何 力 
和 矩 装置 时 ， 它 就 是 一 个 自由 陀螺 仪 。 

在 当前 技术 水 平 条 件 下 ， 陀 螺 仪 传感器 主要 被 用 于 如 下 两 个 领域 。 

(1) 国防 工业 

陀螺 仪 传感器 原本 是 运用 到 直升机 模型 上 的 ， 而 今 已 经 被 广泛 运用 于 手机 类 移动 便携 设备 上 ， 不 
仅仅 如 此 ， 现 代 陀螺 仪 是 一 种 能 够 精确 地 确定 运动 物体 的 方位 的 仪器 ， 所 以 陀螺 仪 传感器 是 现代 航空 、 
航海 、 航 天 和 国防 工业 应 用 中 必 不 可 少 的 控制 装置 。 陀 螺 仪 传感器 是 法 国 的 物理 学 家 莱 昂 。 倩 科 在 研 
究 地 球 自转 时 命名 的 ， 到 如 今 一直 是 航空 和 航海 上 航行 姿态 及 速率 等 最 方便 实用 的 参考 仪表 。 

(2) 开门 报警 器 

陀螺 仪 传感器 可 以 测量 开门 的 角度 ， 当 门 被 打开 一 个 角度 后 会 发 出 报警 声 ， 或 者 结合 GPRS 模块 
发 送 短信 以 提醒 门 被 打开 了 。 另 外 ， 陀 螺 仪 传感器 集成 了 加 速度 传感器 的 功能 ， 当 门 被 打开 的 瞬间 ， 
将 产生 一 定 的 加 速度 值 ， 陀 螺 仪 传感器 将 会 测量 到 这 个 加 速度 值 ， 达 到 预 设 的 门槛 值 后 ， 将 发 出 报警 
声 ， 或 者 结合 GPRS 模块 发 送 短信 以 提醒 门 被 打开 了 。 报 警 器 内 还 可 以 集成 雷达 感应 测量 功能 ， 如 要 
有 人 进入 房间 内 移动 时 就 会 被 雷达 测量 到 。 这 种 双重 保险 提醒 防盗 ， 可 靠 性 高 ， 误 报 率 低 ， 非 常 适合 
重要 场合 的 防盗 报警 。 


5.7.2. Android 中 的 陀螺 仪 传感器 


在 Android 系统 中 ， 陀 螺 仪 传感器 的 类 型 是 TYPE GYROSCOPE, 单位 是 rad/s， 能够 测量 设备 义 、 
Y. Z 三 轴 的 角 加 速度 数据 。Android 中 的 陀螺 仪 传感器 又 名 为 Gyro-sensor 角速度 器 ， 利 用 内 部 震动 机 
械 结构 侦 测 物体 转动 所 产生 的 角速度 ， 进 而 计算 出 物体 移动 的 角度 。 侦 测 水 平 改变 的 状态 ， 但 无 法 计 
算 移 动 的 激烈 程度 。 在 接 下 来 的 内 容 中 ， 将 详细 讲解 Android 中 的 陀螺 仪 传感器 的 基本 知识 。 
(1) 陀螺 仪 传感器 和 加 速度 传感器 的 对 比 
在 Android 的 传感器 系统 中 ， 陀 螺 仪 传感器 和 加 速度 传感器 非常 类 似 ， 两 者 的 区 别 如 下 。 
口 加 速度 传感器 : 用 于 测量 加 速度 ,借助 一 个 三 轴 加 速度 计 可 以 测 得 一 个 固定 平台 相对 地 球 表面 
的 运动 方向 ， 但 是 一 旦 平台 运动 起 来 ， 情 况 就 会 变 得 复杂 得 多 。 如 果 平台 做 自由 落体 ， 加 速度 
计 测 得 的 加 速度 值 为 96。 如果 平台 朝 某 个 方向 做 加 速度 运动 ， 各 个 轴 向 加 速度 值 会 含有 重力 产生 
的 加 速度 值 , 使 得 无 法 获得 真正 的 加 速度 值 。 例如， 安装 在 60” 横 深 角 飞机 上 的 三 轴 加 速度 计 会 
测 得 2g 的 垂直 加 速度 值 , 而 事实 上 飞机 相对 地 区 表面 是 60” 的 倾角 。 因此, 单独 使 用 加 速度 计 无 
法 使 飞机 保持 一 个 固定 的 航向 。 

口 陀螺 仪 传感器 : 用 于 测量 机 体 围绕 某 个 轴 向 的 旋转 角 速 率 值 。 当 使 用 陀螺 仪 测 量 飞 机 机 体 轴 向 的 
旋转 角 速 率 时 , 如 果 飞 机 在 旋转 , 测 得 的 值 为 非 零 值 , 飞机 不 旋转 时 , 测量 的 值 为 0。 因 此 , 160° 
横 滚 角 的 飞机 上 的 陀螺 仪 测 得 的 横 滚 角 速率 值 为 0, 同样 在 飞机 做 水 平 直线 飞行 时 的 角 速 率 值 为 0。 
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可 以 通过 角 速 率 值 的 时 间 积 分 来 估计 当前 的 横 滚 角度 ， 前 提 是 没有 误差 的 累积 。 陀 螺 仪 测 量 的 值 
会 随时 间 漂 移 ， 经 过 几 分 钟 甚至 几 秒 钟 定 会 累积 出 额外 的 误差 来 ， 而 最 终 会 导致 对 飞机 当前 相对 
水 平面 横 滚 角度 完全 错误 的 认 知 。 因 此 ， 单 独 使 用 陀螺 仪 也 无 法 保持 飞机 的 特定 航向 。 

综 上 所 述 ， 加 速度 传感器 在 较 长 时 间 的 测量 值 〈 确 定 飞 机 航向 ) 是 正确 的 ， 而 在 较 短 时 间 内 由 于 
信号 噪声 的 存在 而 有 误差 。 陀 螺 仪 传感器 在 较 短 时 间 内 则 比较 准确 ， 而 较 长 时 间 则 会 由 于 漂移 而 存 有 
误差 。 因 此 ， 需 要 两 者 (相互 调整 ) 来 确保 航向 的 正确 。 

(2) 外 设 项 目 开发 过 程 中 的 陀螺 仪 传感器 

在 外 设 项 目 开 发 过 程 中 ,三 自由 度 陀 螺 仪 是 一 个 可 以 识别 设备 ， 能 够 相对 于 地 面 绕 X、Y、 乙 轴 转 
动 角度 的 感应 器 (自己 的 理解 ， 不 够 严谨 )。 无 论 是 可 移动 设备 ， 还 是 智能 手机 、 平 板 电脑 ， 通 过 使 用 
陀螺 仪 传感器 可 以 实现 很 多 好 玩 的 应 用 ， 例 如 说 指南 针 。 

在 实际 开发 过 程 中 ， 可 以 用 一 个 磁场 感应 器 (Magnetic Sensor) 来 实现 陀螺 仪 。 磁 场 感应 器 是 用 来 
测量 磁场 感应 强度 的 。 一 个 3 轴 的 磁 sensor IC 可 以 得 到 当前 环境 下 X、Y AZ 方向 上 的 磁场 感应 强度 ， 
对 于 Android 中 间 层 来 说 就 是 读 取 该 感应 器 测量 到 的 这 3 个 值 。 当 需要 时 ， 上 报 给 上 层 应 用 程序 。 磁 
感应 强度 的 单位 是 T〈 特 斯 拉 ) 或 者 是 Gs〈 高 斯 )，1T 等 于 10000Gs。 

在 了 解 陀螺 仪 之 前 ， 需 要 先 了 解 Android 系统 定义 坐标 系 的 方法 ， 如 下 所 示 的 文件 中 进行 了 定义 。 

/hardware/libhardware/include/hardware/sensors.h 

在 上 述 文件 sensors.h 中 ， 有 一 个 如 图 5-23 所 示 的 效果 图 。 

5-23 中 表示 设备 的 正 上 方 是 Y 轴 方向 ， 右 边 是 X 轴 方 向 ， 
垂直 设备 屏幕 平面 向 前 的 是 Z 轴 方 向 ， 这 个 很 重要 。 因 为 应 用 程序 
就 是 根据 这 样 的 定义 来 写 的 ， 所 以 我 们 报 给 应 用 的 数据 要 跟 这 个 定 
义 符合 。 还 需要 清楚 磁 Sensor 芯片 贴 在 板 上 的 坐标 系 。 我们 从 芯片 
读 出 数据 后 要 把 芯片 的 坐标 系 转换 为 设备 的 实际 坐标 系 。 除 非 芯片 [7 
贴 在 板 上 刚好 跟 设备 的 X、Y、Z 轴 方 向 一 致 。 | 

陀螺 仪 的 实现 是 根据 磁场 感应 强度 的 3 个 值 计 算出 另外 3 个 值 。 
当 需 要 时 可 以 计算 出 这 3 个 值 上 报 给 应 用 程序 ， 这 样 就 实现 了 陀螺 
仪 的 功能 。 在 接 下 来 的 内 容 中 ， 将 详细 讲解 这 3 个 值 的 具体 含义 和 计算 方法 。 

(1) Azimuth 方位 角 

Azimuth 方位 角 ， 即 绕 Z 轴 转 动 的 角度 ，0”= 正 北 。 假 设 Y 轴 指 向 地 磁 正 北方 ， 直 升 机 正 前 方 的 

方向 如 图 5-24 所 示 ，90”= 正 东 时 如 图 5-25 所 示 。 


22 
5-23 Android 系统 定义 的 坐标 系 


5-24 Azimuth 方位 角 [ 5-25 90”= 正 东 
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180”= 正 南 时 如 图 5-26 所 示 ，270”= 正 西 时 如 图 5-27 所 示 。 
| 


K 5-26 180° =EĦ 图 5-27 270° =IE 


在 这 种 情况 下 ,通过 计算 X 和 YY 方向 的 磁感应 强度 的 反正 切 的 方式 就 可 以 得 到 方位 角 。 要 想 实现 
指南 针 ， 只 需要 用 这 个 值 即 可 (不 考虑 设备 非 水 平 的 情况 )。 

(2) Pitch (Й 

绕 X 轴 转动 的 角度 (-180<=pitch<=180)， 如 果 设 备 水 平 放置 ， 前 方向 下 俯 就 是 正 ， 如 图 5-28 所 示 。 

前 方向 上 仰 就 是 负 值 ， 如 图 5-29 所 示 。 


5-28 ”前 方向 下 俯 就 是 正 5-29 前 方向 上 仰 就 是 负 值 
在 这 种 情况 下 ， 计 算 磁 Sensor 的 Y 和 ZZ 反 正切 就 可 以 得 到 此 角度 值 ， 如 图 5-30 所 示 。 


图 5-30 计算 磁 Sensor 的 Y 和 Z 反 正切 
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ШЫ 知识 点 讲解 :光盘 :视频 \ 知 识 点 第 5 章 \ 距 离 传感器 详解 .avi 

在 Android 设备 应 用 程序 开发 过 程 中 ， 经 常 需要 检测 设备 的 运动 数据 ， 例 如 设备 的 运动 速率 和 运 
动 距离 等 。 这 些 数 据 对 于 健身 类 设备 来 说 都 是 十 分 重要 的 ， 例 如 健身 手表 可 以 及 时 测试 晨练 的 运动 距 
离 和 速率 。 在 Android 系统 中 ， 通 常 使 用 加 速度 传感器 、 线 性 加 速度 传感器 和 距离 传感器 来 检测 设备 
的 运动 数据 。 本 节 将 详细 讲解 在 Android 设备 中 检测 运动 数据 的 基本 知识 。 


5.8.1 距离 传感器 介绍 


在 Android 系统 中 ， 需 要 使 用 加 速度 传感器 、 线 性 加 速度 传感器 和 距离 传感器 来 检测 设备 的 运动 
数据 。 在 当前 的 技术 条 件 下 ， 距 离 传感器 是 指 利 用 “飞行 时 间 法 ”(flying time) 的 原理 来 实现 测量 距 
离 ， 以 实现 检测 物体 距离 的 一 种 传感器 。“ 飞 行 时 间 法 ”是 通过 发 射 特别 短 的 光 脉 冲 ， 并 测量 此 光 脉 冲 
从 发 射 到 被 物体 反射 回来 的 时 间 ， 通 过 测 时 间 间 隔 来 计算 与 物体 之 间 的 距离 。 

在 现实 世界 中 ， 距 离 传感器 在 智能 手机 中 的 应 用 比较 常见 。 一 般 触 屏 智能 手机 在 默认 设置 下 ， 都 
会 有 一 个 延 时 锁 屏 的 设置 ， 就 是 在 一 段 时 间 内 ， 手 机 检测 不 到 任何 操作 ， 就 会 进入 锁 屏 状态 。 这 样 是 
有 一 定好 处 的 。 手 机 作为 移动 终端 的 一 种 ， 追 求 低 功 耗 是 设计 的 目标 之 一 。 延 时 锁 屏 既 可 以 避免 不 必 
要 的 能 量 消耗 ， 又 能 保证 不 丢失 重要 信息 。 另 外 ， 在 使 用 触 屏 手机 设备 时 ， 当 接 电话 的 时 候 距 离 传 感 
器 会 起 作用 ， 当 脸 靠近 屏幕 时 屏幕 灯会 熄灭 ， 并 自动 锁 屏 ， 这 样 可 以 防止 脸 误 操作 。 当 脸 离 开 屏 幕 时 
屏幕 灯会 自动 开启 ， 并 且 自 动 解锁 。 

除了 被 广泛 应 用 于 手机 设备 之 外 ， 距 离 传 感 器 还 被 用 于 时 外 环境 (山体 情况 、 峡 谷 深度 等 )、 飞 机 
高 度 检测 、 矿 井深 度 、 物 料 高 度 测量 等 领域 ， 并 且 在 野外 应 用 领域 中 ， 主 要 用 于 检测 山体 情况 和 峡谷 
深度 等 。 而 对 飞机 高 度 测量 功能 是 通过 检测 飞机 在 起 飞 和 降落 时 距离 地 面 的 高 度 ， 并 将 结果 实时 显示 
在 控制 面板 上 ， 也 可 以 使 用 距离 传感器 测量 物料 各 点 高 度 ， 用 于 计算 物料 的 体积 。 在 显示 应 用 中 ， 用 
于 飞机 高 度 和 物料 高 度 的 距离 传感器 有 LDM301 系列 ， 用 于 野外 应 用 的 距离 传感器 有 LDM4x 系列 。 

在 当前 的 可 设备 应 用 中 ， 距 离 传感器 被 应 用 于 智能 皮带 中 。 在 皮带 扣 里 嵌入 了 距离 传感器 ， 当 把 
皮带 调整 至 合适 宽度 、 卡 好 皮带 扣 后 ， 如 果皮 带 在 ТО 秒 钟 内 没有 重新 解 开 ， 传感器 就 会 自动 生成 本 次 
的 腰围 数据 。 皮 带 与 皮带 扣 连 接 处 的 其 中 一 枚 锦 钉 将 被 数据 传输 装置 所 替代 。 当 你 将 智能 手机 放 在 锦 
钉 处 保持 两 秒 钟 静止 ， 手 机 里 的 自我 健康 管理 App 会 被 自动 激活 ， 并 获取 本 次 腰围 数据 。 


5.8.2 Android 系统 中 的 距离 传感器 


在 Android 系统 中 ， 距 离 传感器 也 被 称 为 P-Sensor， 值 是 TYPE PROXIMITY， 单 位 是 cm， 能 够 测 
量 某 个 对 象 到 屏幕 的 距离 。 可 以 在 打 电 话 时 判断 人 耳 到 电话 屏幕 的 距离 ， 以 关闭 屏幕 而 达到 省 电 功 能 。 

P-Sensor 主要 用 于 在 通话 过 程 中 防止 用 户 误 操作 屏幕 ， 接 下 来 以 通话 过 程 为 例 来 讲解 电话 程序 对 
P-Sensor 的 操作 流程 。 

CD 在 启动 电话 程序 的 时 候 ， 在 “java” 文 件 中 新 建 了 一 个 P-Sensor 的 WakeLock 对 象 ， 其 代码 
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如 下 所 示 。 
mProximityWakeLock = pm.newWakeLock( 
PowerManager.PROXIMITY_SCREEN_OFF_WAKE_LOCK, LOG TAG 
); 
对 象 wackLock 的 功能 是 请 求 控制 屏幕 的 点 亮 或 熄灭 。 
O) 在 电话 状态 发 生 改 变 时 ,例如 接 通 了 电话 ， 调 用 “.java” 文 件 中 的 方法 根据 当前 电话 的 状态 
来 决定 是 否 打开 P-Sensor。 如 果 在 通话 过 程 中 ， 电 话 是 OFF-HOOK 状态 时 打开 P-Sensor， 其 演示 代码 
如 下 。 
if (ImProximityWakeLock.isHeld()){ 
if (DBG) Log.d(LOG_TAG, "updateProximitySensorMode: acquiring..."); 
mProximityWakeLock.acquire(); 
} 
在 上 述 代码 中 ，mProximityWakeLock.acquire() 会 调用 到 另外 的 方法 打开 P-Sensor， 这 个 另外 的 方 
法 会 判断 当前 手机 有 没有 P-Sensor。 如 果 有 ,就 会 向 SensorManager 注册 一 个 P-Sensor 监听 器 。 这 样 当 
P-Sensor 检测 到 手机 和 人 体 距 离 发 生 改变 时 ， 就 会 调用 服务 监听 器 进行 处 理 。 同 样 ， 当 电话 挂 断 时 ， 
电话 模块 会 去 调用 方法 取消 P-Sensor 监听 器 。 
在 Android 系统 中 ，PowerManagerService 中 P-Sensor 监听 器 会 进行 实时 监听 工作 ， 当 P-Sensor 检 
测 到 距离 有 变化 时 就 会 进行 监听 。 具 体 监听 过 程 的 代码 如 下 所 示 。 
SensorEventListener mProximityListener = new SensorEventListener() { 
public void onSensorChanged(SensorEvent event) { 
long milliseconds = SystemClock.elapsedRealtime(); 
synchronized (mLocks) { 
float distance = event.values[0]; /检测 到 手机 和 人 体 的 距离 
long timeSinceLastEvent = milliseconds - mLastProximityEventTime; /这 次 检测 和 上 次 检测 


的 时 间 差 
mLastProximityEventTime = milliseconds; // 更 新 上 一 次 检测 的 时 间 
mHandler.removeCallbacks(mProximityTask); 
boolean proximityTaskQueued = false; 


1/ compare against getMaximumRange to support sensors that only return 0 or 1 
boolean active = (distance >= 0.0 && distance < PROXIMITY_THRESHOLD && 
distance < mProximitySensor.getMaximumRange()); /如 果 距 离 小 于 某 一 个 距离 阔 
值 ， 默 认 是 5.0f， 说 明 手 机 和 脸 部 距离 贴近 ， 应 该 要 熄灭 屏幕 


if (mDebugProximitySensor) { 
Slog.d(TAG, "mProximityListener.onSensorChanged active: " + active); 
} 
if (timeSinceLastEvent < PROXIMITY SENSOR DELAY)( 
II enforce delaying atleast PROXIMITY SENSOR DELAY before processing 
mProximityPendingValue = (active ? 1 : 0); 
mHandler.postDelayed(mProximityTask, PROXIMITY SENSOR DELAY - timeSincel ast - 
Event); 
proximityTaskQueued - true; 
) else { 
II process the value immediately 
mProximityPendingValue = -1; 
proximit/ChangedLocked(active); /熄灭 屏幕 操作 
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} 


I| update mProximityPartialLock state 

boolean held = mProximityPartialLock.isHeld(); 

if (held && proximityTaskQueued) { 
JI hold wakelock until mProximityTask runs 
mProximityPartialLock.acquire(); 

} else if (held && !proximityTaskQueued) { 
mProximityPartialLock.release(); 

} 

} 
} 


public void onAccuracyChanged(Sensor sensor, int accuracy) { 
II ignore 
Я } 

由 上 述 代 码 可 知 ， 在 监听 时 会 首先 通过 “float distance = event.values[0];” 获 取 变 化 的 距离 。 如 果 
发 现 检测 这 次 距离 变化 和 上 次 距离 变化 时 间 差 ， 例 如 小 于 系统 设置 的 闵 值 则 不 会 去 熄灭 屏幕 。 过 于 频 
繁 的 操作 系统 会 忽略 掉 。 如 果 感 觉 P-Sensor 不 够 灵敏 ， 可 以 修改 如 下 所 示 的 系统 默认 值 。 

private static final int PROXIMITY_SENSOR_DELAY = 1000; 

将 上 述 值 改 小 后 就 会 发 现 P-Sensor 会 变 得 灵敏 很 多 。 

如 果 P-Sensor 检测 到 这 次 距离 变化 小 于 系统 默认 值 ， 并 且 这 次 是 一 次 正常 的 变化 ， 那 么 需要 通过 


如 下 代码 熄灭 屏幕 。 
proximityChangedLocked(active); 
此 处 会 判断 P-Sensor 是 否 可 以 用 ， 如 果 不 可 用 则 返回 ， 并 忽略 这 次 距离 变化 。 
if (ImProximitySensorEnabled) ( 
Slog.d(TAG, "Ignoring proximity change after sensor is disabled"); 
return; 
} 


如 果 一 切 都 满足 ， 则 调用 如 下 代码 灭 灯 。 
goToSleepLocked(SystemClock.uptimeMillis(), 
WindowManagerPolicy.OFF_BECAUSE_OF_PROX_SENSOR); 
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GEO 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 5 章 \ 气 压 传感器 详解 .avi 

在 Android 设备 开发 应 用 过 程 中 , 通常 需要 使 用 设备 来 感知 当前 所 处 环境 的 信息 , 例如 气压 .GPS、 
海拔 、 湿 度 和 温度 。 在 Android 系统 中 ， 专 门 提供 了 气压 传感器 、 海 拔 传感器 、 湿 度 传感器 和 温度 伟 
感 器 来 支持 上 述 功能 。 本 节 将 详细 讲解 在 Android 设备 中 使 用 气压 传感器 详解 的 基本 知识 ， 为 读者 学 
习 本 书后 面 的 知识 打下 基础 。 
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在 现实 应 用 中 ， 气 压 传感器 主要 用 于 测量 气体 的 绝对 压强 ， 主 要 适用 于 与 气体 压强 相关 的 物理 实 
验 ， 如 气体 定律 等 ， 也 可 以 在 生物 和 化 学 实验 中 测量 干燥 、 无 腐蚀 性 的 气体 压强 。 气 压 传感器 的 原理 
比较 简单 ， 其 主要 的 传 感 元 件 是 一 个 对 气压 传感器 内 的 强 弱 敏感 的 薄膜 和 一 个 顶 针 开关 控制 ， 电 路 方 
面 它 连接 了 一 个 柔性 电阻 器 。 当 被 测 气体 的 压强 降低 或 升 高 时 ， 这 个 薄膜 变形 带动 项 针 ， 同 时 该 电阻 
器 的 阻 值 将 会 改变 。 从 传 感 元 件 取得 O~SV 的 信号 电压 ， 经 过 АЛО 转换 由 数据 采集 器 接收 ， 然 后 数据 
采集 器 以 适当 的 形式 把 结果 传送 给 计算 机 。 

在 现实 应 用 中 ， 很 多 气压 传感器 的 主要 部 件 为 变 容 式 硅 膜 盒 。 当 该 变 容 硅 膜 盒 受 外界 大 气压 力 发 
生变 化 时 项 针 动 作 ， 单 晶 硅 膜 盒 随 着 发 生 弹 性 变形 ， 从 而 引起 硅 膜 盒 平行 板 电容 器 电容 量 的 变化 来 控 
制 气压 传感器 。 

国标 GB7665 一 87 对 传感器 的 定义 是 :“ 能 感受 规定 的 被 测量 并 按照 一 定 的 规律 转换 成 可 用 信号 的 
器 件 或 装置 ,通常 由 敏感 元 件 和 转换 元 件 组 成 ”。 而 气压 传感器 是 由 一 种 检测 装置 ， 能 感受 到 被 测量 的 
信息 ， 并 能 将 检测 感受 到 的 信息 ， 按 一 定 规律 变换 成 为 电信 号 或 其 他 所 需 形 式 的 信息 输出 ， 以 满足 信 
息 的 传输 、 处 理 、 存 储 、 显 示 、 记 录 和 控制 等 要 求 ， 是 实现 自动 化 检测 和 控制 的 首要 环节 。 


5.9.2 气压 传感器 在 智能 手机 中 的 应 用 


随 着 智能 手机 设备 的 发 展 ， 气 压 传感器 得 到 了 大 力 的 普及 。 气 压 传感器 首次 在 智能 手机 上 使 用 是 
1E Galaxy Nexus 上 ,而 之 后 推出 的 一 些 Android 旗舰 手机 里 也 包含 了 这 一 传感器 , 像 Galaxy SI, Galaxy 
Note 2 也 都 有 。 对 于 喜欢 登山 的 人 来 说 ， 都 会 非常 关心 自己 所 处 的 高 度 。 海 拔高 度 的 测量 方法 ， 一 般 
常用 的 有 两 种 方式 ， 一 是 通过 GPS 全 球 定位 系统 ， 二 是 通过 测 出 大 气压 ， 然 后 根据 气压 值 计算 出 海拔 
高 度 。 由 于 受到 技术 和 其 他 方面 原因 的 限制 ，GPS 计算 海拔 高 度 一 般 误 差 都 会 有 十 米 左 右 ， 而 如 果 在 
树林 里 或 者 是 在 悬崖 下 面 时 ， 有 时 候 甚至 接收 不 到 GPS 卫星 信号 。 同 时 当 用 户 处 于 楼 宇内 时 ， 内 置 感 
应 器 可 能 会 无 法 接收 到 GPS 信号 ， 从 而 不 能 够 识别 地 理 位 置 。 配 合 气压 传感器 、 加 速 计 、 陀 螺 仪 等 就 
能 够 实现 精确 定位 。 这 样 当 你 在 商场 购物 时 ， 你 能 够 更 好 找到 目标 商品 。 

另外 在 汽车 导航 领域 中 ,经 常会 有 人 抱怨 在 高 架 桥 里 导航 常常 会 出 错 。 比 如 在 高 架 桥 上 时 ，GPS 
说 右 转 ， 而 实际 上 右边 根本 没有 右 转 出 口 ， 这 主要 是 GPS 无 法 判断 你 是 桥 上 还 是 桥 下 而 造成 的 错误 
导航 。 一 般 高 架 桥 上 下 两 层 的 高 度 都 会 有 几米 到 十 几米 的 距离 ， 而 GPS 的 误差 可 能 会 有 几 十 米 ， 所 
以 发 生 错误 的 导航 也 就 可 以 理解 了 。 此 时 如 果 在 手机 中 增加 一 个 气压 传感器 就 不 一 样 了 ， 它 的 精度 
可 以 做 到 1 米 的 误差 ， 这 样 就 可 以 很 好 地 辅助 GPS 来 测量 出 所 处 的 高 度 ， 错 误导 航 的 问题 也 就 容易 
解决 了 。 

而 气压 的 方式 可 选择 的 范围 会 广 些 ， 而 且 可 以 把 成 本 可 以 控制 在 比较 低 的 水 平 。 另 外 像 Galaxy 
Nexus 等 手机 的 气压 传感器 还 包括 温度 传感器 , 它 可 以 捕捉 到 温度 来 对 结果 进行 修正 ， 以 增加 测量 结 
果 的 精度 。 所 以 在 手机 原 有 GPS 的 基础 上 再 增加 气压 传感器 的 功能 ， 可 以 让 三 维 定位 更 加 精准 。 

在 Android 系统 中 ， 气 压 传感器 的 类 型 是 TYPE PRESSURE， 单 位 是 hPa (〈 百 帕斯卡 )， 能 够 返回 
当前 环境 下 的 压强 。 
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温度 传感器 从 17 世纪 初 人 们 开始 利用 温度 进行 测量 。 在 半导体 技术 的 支持 下 , 现在 相继 开发 了 半 
导体 热电 偶 传感器 、PN 结 温度 传感器 和 集成 温度 传感器 。 与 之 相应 ， 根 据 波 与 物质 的 相互 作用 规律 ， 
相继 开发 了 声学 温度 传感器 、 红 外 传感器 和 微波 传感器 。 温 度 传感器 是 五 花 八 门 的 各 种 传感器 中 最 为 
常用 的 一 种 ， 现 代 的 温度 传感器 外 形 非 常 小 ， 这 样 更 加 让 它 广泛 应 用 在 生产 实践 的 各 个 领域 中 ， 也 为 
人 们 的 生活 提供 了 无 数 的 便利 。 

在 现实 应 用 中 ， 温 度 传感器 有 4 种 主要 类 型 热电 偶 、 热 敏 电阻 、 电 阻 温度 检测 器 RTD) 和 IC 
温度 传感器 。IC 温度 传感器 又 包括 模拟 输出 和 数字 输出 两 种 类 型 。 在 现实 世界 中 ， 温 度 传感器 是 温度 
测量 仪表 的 核心 部 分 ， 品 种 繁多 。 按 测量 方式 可 以 分 为 接触 式 和 非 接触 式 两 大 类 ， 按 照 传 感 器 材料 及 
电子 元 件 特性 分 为 热电 阻 和 热电 偶 两 类 。 

在 当前 的 技术 水 平 条 件 下 ， 温 度 传感器 的 主要 原理 如 下 。 

(1) 金属 膨胀 原理 设计 的 传感器 

金属 在 环境 温度 变化 后 会 产生 一 个 相应 的 延伸 ， 因 此 传感器 可 以 以 不 同方 式 对 这 种 反应 进行 信号 
转换 。 

(2) 双 金 属 片 式 传感器 

双 金 属 片 由 两 片 不 同 膨 胀 系数 的 金属 贴 在 一 起 而 组 成 ， 随 着 温度 变化 ， 材 料 A 比 另外 一 种 金属 脱 
胀 程度 要 高 ， 引 起 金属 片 弯曲 。 弯 曲 的 曲率 可 以 转换 成 一 个 输出 信号 。 

G) 双人 金属 杆 和 金属 管 传感器 

随 着 温度 升 高 ， 金 属 管 ( 材 料 A) 长 度 增加 ， 而 不 膨胀 钢 杆 〈 人 金属 B) 的 长 度 并 不 增加 ， 这 样 由 
于 位 置 的 改变 ， 金 属 管 的 线性 膨胀 就 可 以 进行 传递 。 反 过 来 ， 这 种 线性 膨胀 可 以 转换 成 一 个 输出 信号 。 

(4) 液体 和 气体 的 变形 曲线 设计 的 传感器 

在 温度 变化 时 ， 液 体 和 气体 同样 会 相应 产生 体积 的 变化 。 

综 上 所 述 ， 多 种 类 型 的 结构 可 以 把 这 种 膨胀 的 变化 转换 成 位 置 的 变化 ， 这 样 产生 位 置 的 变化 可 以 
输出 为 电位 计 、 感 应 偏差 、 挡 流 板 等 形式 的 结果 。 

在 Android 系统 中 ， 早 期 版 本 的 温度 传感器 值 是 TYPE TEMPERATURE, ， 在 新 版 本 中 被 
TYPE AMBIENT TEMPERATURE BË, Android 温度 传感器 的 单位 是 'C, 能 够 测量 并 返回 当前 的 温度 。 

在 Android 内 核 的 平台 中 自 带 了 大 量 的 传感器 源码 , 读者 可 以 在 Rexsee 的 开源 社区 http://www.rexsee. 
com/ 找 到 相关 的 源 代码 。 
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人 类 的 生存 和 社会 活动 与 湿度 密切 相关 。 随 着 现代 化 的 实现 ， 很 难 找 出 一 个 与 湿度 无 关 的 领域 来 。 
由 于 应 用 领域 不 同 ， 对 湿度 传感器 的 技术 要 求 也 不 同 。 
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在 Android 系统 中 ， 湿 度 传感器 的 值 是 TYPE _ RELATIVE_HUMIDITY， 单 位 是 %， 能 够 测量 周围 环 
境 的 相对 湿度 。Android 系统 中 的 湿度 与 光线 、 气 压 、 温 度 传感器 的 使 用 方式 相同 ， 可 以 从 湿度 传感器 中 
读 取 到 相对 湿度 的 原始 数据 。 而 且 ， 如 果 设 备 同 时 提供 了 湿度 传感器 (TYPE RELATIVE HUMIDITY) 
和 温度 传感器 (TYPE_AMBIENT_TEMPERATURE), 那么 就 可 以 用 这 两 个 数据 流 来 计算 出 结 露点 和 绝 
对 湿度 。 

(1) 结 露点 

结 露点 是 在 固定 的 气压 下 ， 空 气 中 所 含 的 气态 水 达到 饱和 而 凝结 成 液态 水 所 需要 降 至 的 温度 。 以 
下 给 出 了 计算 结 露点 温度 的 公式 : 
In(RH/100%) + m- t/(T,+t) 
tbRH =T,- 

m - [In(RH/100%) + m-t/(T,+t)] 

在 上 述 公式 中 ， 各 个 参数 的 具体 说 明 如 下 。 
оО y= 结 露点 温度 ， 单 位 是 C。 
О t= 当前 温度 ， 单 位 是 'C。 
о 
Q 


RH = 当前 相对 湿度 ， 单 位 是 百分比 (%) 。 
т = 18.62。 
О T,=243.12, 
(2) 绝对 湿度 
绝对 湿度 是 在 一 定 体积 的 干燥 空气 中 含有 的 水 蒸气 的 质量 。 绝 对 湿度 的 计量 单位 是 gms UFA 
出 了 计算 绝对 湿度 的 公式 : 
d,(t,RH) = 218.7. 


在 上 述 公 式 中 ， 各 个 参数 的 具体 说 明 如 下 。 

а а= 绝对 湿度 ， 单 位 是 gmz。 

О t= 当前 温度 ， 单 位 是 'C。 

О RH= 当前 相对 湿度 ， 单 位 是 百分比 oo. 
а 

а 

а 


(RH/100%) - A -exp(m-t/(T,+t)) 
273.15 +1 


т = 18.62. 
Т, = 243.12°C. 
А = 6.112 hPa, 


BGS 蓝牙 系统 详解 


蓝牙 这 一 名 称 来 自 于 10 世纪 的 一 位 丹麦 国王 Harald Blatand，Blatand 在 英文 里 的 意思 可 以 被 解释 
为 Bluetooth。 因 为 国王 喜欢 吃 蓝 莓 ， 牙 龊 每 天 都 是 蓝 色 的 所 以 叫 蓝牙 。 蓝 牙 的 创始 人 是 瑞典 爱立信 公 
司 ， 爱 立信 早 在 1994 年 就 已 进行 研发 。1997 年 ， 爱 立信 与 其 他 设备 生产 商 联系 ,并 激发 了 他 们 对 该 项 
技术 的 浓厚 兴趣 。1998 年 2 月 ，5 个 跨国 大 公司 ， 包 括 爱立信 、 诺 基 亚 、IBM、 东 芝 及 Intel 组 成 了 一 
个 特殊 兴趣 小 组 (SIG)， 他 们 共同 的 目标 是 建立 一 个 全 球 性 的 小 范围 无 线 通信 技术 ， 也 就 是 现在 的 蓝 
F. 在 Android 设备 中 ,蓝牙 技术 是 常用 的 一 种 近 距 离 数据 传输 技术 。 本 章 将 详细 讲解 Android 蓝牙 系 
统 的 基本 架构 知识 。 
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在 Android 外 设 项 目 开发 应 用 中 ， 需 要 建立 外 部 设备 与 控制 设备 的 连接 ， 此 时 发 挥 关 键 作用 的 是 
短 距离 无 线 传输 技术 。 目 前 有 多 种 短 距离 无 线 传输 技术 可 以 应 用 在 外 设 项 目 开 发 过 程 中 ， 在 现实 中 除 
了 已 经 得 到 大 规模 应 用 的 RFID 之 外 ， 还 有 WiFi、ZigBee、 蓝 牙 等 比较 成 熟 的 技术 ， 以 及 基于 这 些 技 
术 发 展 而 来 的 新 技术 。 这 些 技术 各 具 特点 ， 因 对 其 传输 速度 、 距 离 、 耗 电量 等 方面 的 要 求 不 同 ， 形 成 
了 各 自 不 同 的 外 设 项 目 开发 过 程 应 用 场景 。 本 节 将 简要 介绍 当今 可 以 实现 短 距 离 无 线 通信 功能 的 常用 
技术 。 


6.1.1 ZigBee 


ZigBee 以 其 鲜明 的 技术 特点 在 外 设 项 目 开 发 过 程 中 受到 了 高 度 关注 ， 该 技术 使 用 的 频段 分 别 为 
2.4GHz、868MHz (欧洲 ) 及 915MHz (美国 )。 其 主要 的 技术 特点 : 一 是 数据 传输 速率 低 , 只 有 LOKbps~ 
250Kbps; 二 是 功 耗 低 ， 低 传输 速率 带 来 了 仅 为 1 毫 瓦 的 低 发 射 功率 。 据 估算 ，ZigBee 设备 仅 靠 两 节 5 
号 电池 就 可 以 维持 长 达 6 个 月 到 两 年 左右 的 使 用 时 间 ， 这 是 ZigBee 的 一 个 独特 优势 ， 三 是 成 本 低 ， 因 
为 ZigBee 传输 速率 低 、 协 议 简单 ; 四 是 网 络 容量 大 ， 每 个 ZigBee 网 络 最 多 可 以 支持 255 个 设备 ， 一 
个 区 域内 可 以 同时 存在 最 多 100 个 ZigBee 网 络 ， 网 络 组 成 灵活 。ZigBee 芯片 主要 企业 有 德州 仪器 、 飞 
思 卡 尔 等 。 市 场 调研 机 构 ABI Reserch 的 一 份 数据 显示 ，2005 一 2012 Æ, ZigBee 市 场 的 年 均 复合 增长 
率 为 63%。 

ZigBee 是 从 家 庭 自 动 化 开始 的 ， 在 瑞典 哥德堡 就 是 从 智能 电表 开始 ， 然 后 进一步 用 到 燃气 表 、 水 
表 、 热 力 表 等 家 庭 各 种 计量 表 。 在 2011 年 中 国 无 线 世界 既 外 设 项 目 开发 过 程 大 会 上 ，ZigBee 联盟 大 中 
华 区 代表 黄 家 瑞 说 ,“ZigBee 在 智能 电表 里 不 仅仅 是 远程 抄 表 工 具 ， 它 是 一 个 终端 ， 也 是 一 个 网 关 ， 这 
些 网 关 结 合 在 一 起 ， 整 个 小 区 就 变 成 了 智能 电网 小 区 ， 智 能 电表 可 以 搜集 家 里 所 有 家 电 的 用 电信 息 。” 


Hif, ZigBee 正在 完善 其 网 关 标 准 ，2011 年 7 月 底 发 布 了 第 十 个 标准 ZigBee Gateway (ZigBee 网 
关 )。ZigBee Gateway 提供 了 一 种 简单 、 高 成 本 效益 的 互联 网 连接 方式 ， 使 服务 提供 商 、 企 业 和 个 人 消 
费 者 有 机 会 运行 这 些 设 备 并 将 ZigBee 网 络 连接 至 互联 网 。ZigBee Gateway 是 ZigBee Network Devicesp 

(ZigBee 网 络 设备 ) 这 一 新 类 别 范畴 的 首 个 标准 ， 这 将 使 ZigBee 发 展 进一步 提速 。 


6.1.2 WiFi 


WiFi 是 以 太 网 的 一 种 无 线 扩展 技术 ， 如 果 有 多 个 用 户 同时 通过 一 个 热点 接 入 ， 带 宽 将 被 这 些 用 户 
共享 ，WiFi 的 速率 会 降低 ， 处 于 2.4GHz 频段 的 WiFi 信号 受 墙壁 阻隔 的 影响 较 小 。WiFi 的 传输 速率 
随 着 技术 的 演进 还 在 不 断 提 高 ， 我 国电 信 运 营 商 在 构建 无 线 城市 中 采用 的 WiFi 技术 部 分 已 经 升级 到 
802.11n， 最 高 速率 从 802.11 g 标准 的 11Mbps 提高 到 50Mbps 以 上 。 在 WiFi 产业 链 中 ， 最 大 的 芯片 企 
业 是 博通 。 

在 笔记 本 电脑 和 手机 上 已 经 得 到 广泛 应 用 的 WiFi 正在 向 消费 电子 产品 渗透 , Myron Hattig 说 :“ 除 
了 手机 外 ， 已 经 有 25% 的 消费 类 电子 设备 使 用 WiFi， 在 打印 机 、 洗 衣 机 上 都 在 使 用 WiFi， 家 用 电器 生 
产 商 协会 将 WiFi 作为 一 个 更 高 级 别 的 智能 电器 沟通 技术 。WiFi 可 以 将 设备 与 设备 相连 ， 从 而 使 整个 
家 庭 的 家 用 电器 、 电 子 设备 相连 。” 

最 大 WiFi 芯片 制造 商 博通 正在 推动 WiFi Direct 标准 的 商用 ， 以 支持 这 种 设备 到 设备 的 直 连 。 特 
别 是 在 家 庭 互联 中 ， 相 片 、 视 频 等 大 数据 量 的 业务 在 手机 、 平 板 电脑 、 电 视 等 设备 中 的 直 连 应 用 前 
ЖГ. 

基于 WiFi 上 发 展 起 来 的 WIGIG 也 是 未 来 家 庭 互 联 市 场 有 力 的 竞争 技术 。 该 技术 可 工作 在 40~ 
60GHz 的 超 高 频段 ， 其 传输 速度 可 以 达到 1Gbps 以 上 ， 不 能 穿 过 墙壁 。 目 前 英特尔 、 高 通 等 芯片 企业 
在 支持 WIGIG 发 展 ， 该 技术 还 在 完善 中 ， 如 需要 进一步 降低 功 耗 等 。 


6.1.3 蓝牙 


IE EF” (Bluetooth) 技术 可 以 有 效 地 简化 移动 通信 终端 设备 之 间 的 通信 ， 也 能 够 成 功 地 简化 
设备 与 因特网 (Internet) 之 间 的 通信 ， 从 而 使 数据 传输 变 得 更 加 迅速 高 效 ， 为 无 线 通信 拓宽 道路 。 蓝 
牙 采用 分 散 式 网 络 结构 以 及 快 跳 频 和 短 包 技术 ,支持 点 对 点 及 点 对 多 点 通信 ,工作 在 全 球 通用 的 2.4GHz 
ISM 〈 即 工业 、 科 学 、 医 学 ) 频段 。 蓝 牙 技 术 的 数据 传输 速率 为 1Mbps， 采 用 时 分 双 工 传输 方案 实现 
全 双 工 传输 。 

蓝牙 是 一 种 无 线 传输 技术 ， 许 多 行业 的 制造 商都 积极 地 在 其 产品 中 实施 此 技术 ， 以 减少 使 用 零乱 
的 电线 ， 实 现 无 颖 连接 、 流 传输 立体 声 ， 传 输 数据 或 进行 语音 通信 。Bluetooth 技术 在 24 GHz 波段 运 
行 ,该 波段 是 一 种 无 须 申请 许可 证 的 工业 、 科 技 、 医 学 ASM) 无 线 电波 段 。 正 因 如 此 ， 使 用 Bluetooth 
技术 不 需要 支付 任何 费用 。 但 必须 向 手机 提供 商 注 册 使 用 GSM 或 CDMA, 除了 设备 费用 外 ， 不 需要 
为 使 用 Bluetooth 技术 再 支付 任何 费用 。 

Bluetooth 技术 得 到 了 空前 广泛 的 应 用 ， 集 成 该 技术 的 产品 从 手机 、 汽 车 到 医疗 设备 ， 使 用 该 技术 
的 用 户 从 消费 者 、 工 业 市 场 到 企业 等 ， 不 一 而 足 。 低 功 耗 、 小 体积 以 及 低 成 本 的 芯片 解决 方案 使 得 
Bluetooth 技术 甚至 可 以 应 用 于 极 微小 的 设备 中 。 

Bluetooth 技术 是 一 项 即时 技术 ， 它 不 要 求 固定 的 基础 设施 ， 且 易于 安装 和 设置 ， 不 需要 电缆 即 可 
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实现 连接 。 新 用 户 使 用 亦 不 费力 ， 我 们 只 需 拥 有 Bluetooth 品牌 产品 ， 检 查 可 用 的 配置 文件 ， 将 其 连接 
至 使 用 同一 配置 文件 的 另 一 Bluetooth 设备 即 可 。 后 续 的 PIN 码 流程 就 如 同 在 ATM 机 器 上 操作 一 样 简 
单 。 外 出 时 ， 可 以 随身 带 上 个 人 局 域 网 (PAN)， 甚 至 可 以 与 其 他 网 络 连接 。 

蓝牙 可 以 在 包括 移动 电话 、PDA、 无 线 耳 机 、 笔 记 本 电脑 、 相 关外 设 等 众多 设备 之 间 进 行 无 线 信 
息 交 换 。 蓝 牙 采用 分 散 式 网 络 结构 以 及 快 跳 频 和 短 包 技 术 ， 支 持 点 对 点 及 点 对 多 点 通信 ， 工 作 在 全 球 
通用 的 2.4GHz 频段 ， 其 数据 速率 为 1Mbps。 

2010 年 7 月 ， 以 低 功 耗 为 特点 的 蓝牙 4.0 标准 推出 ， 蓝 牙 大 中 华 区 技术 市 场 经 理 吕 荣 良 将 其 看 作 
蓝牙 第 二 波 发 展 高 潮 的 标志 ， 他 表示 :“ 蓝牙 可 以 跨 领域 应 用 ， 主 要 有 4 个 生态 系统 ,分 别 是 智能 手机 
与 笔记 本 电脑 等 终端 市 场 、 消 费 电子 市 场 、 汽 车 前 装 市 场 和 健身 运动 器 材 市 场 。” 

МЕС 和 UWB 曾经 是 十 分 受 关注 的 短 距离 无 线 接 入 技术 , 但 其 发 展 已 经 日 渐 势 微 。 业 内 专家 认为 ， 
无 线 频谱 的 规划 和 利用 在 短 距离 通信 中 日 益 重 要 。 短 距离 通信 技术 目前 主要 采用 2.4GHz 的 开放 频谱 ， 
但 随 着 外 设 项 目 开发 过 程 的 发 展 和 大 量 短 距离 通信 技术 的 应 用 ， 频 谱 需 求 会 快速 增长 ， 视 频 、 图 像 等 
大 数据 量 的 通信 正在 寻求 更 高 频段 的 解决 方案 。 


6.14 МЕС 


МЕС 是 近 场 通信 (Near Field Communication) 的 缩写 ， 此 技术 由 非 接触 式 射 频 识 别 (RFID ) 演变 
而 来 ， 由 飞利浦 半导体 ( 现 恩 智 浦 半导体 )、 诺 基 亚 和 索尼 共同 研制 开发 ， 其 基础 是 RFID 及 互 连 技术 。 
NFC 是 一 种 短 距 高 频 的 无 线 电 技术 ,在 13.56MHz 频率 运行 于 20 厘米 距离 内 。 其 传输 速度 有 106 Kbit/s, 
212 Kbit/s 或 者 424 Kbit/s 3 种 , EIRA ISO/IEC IS 18092 国际 标准 .ECMA-340 标准 与 ETSI TS 102 190 
标准 。NFC 采用 主动 和 被 动 两 种 读 取 模式 。 

МЕС 近 场 通信 技术 是 由 非 接触 式 射频 识别 (RFID) 及 互联 互通 技术 整合 演变 而 来 ， 在 单一 芯片 上 
结合 感应 式 读 卡 器 、 感 应 式 卡片 和 点 对 点 的 功能 ， 能 在 短 距离 内 与 兼容 设备 进行 识别 和 数据 交换 。 工 
作 频 率 为 13.36MHz， 但 是 使 用 这 种 手机 支付 方案 的 用 户 必须 更 换 特制 的 手机 。 目 前 这 项 技术 在 日 韩 被 
广泛 应 用 。 手 机 用 户 赁 着 配置 了 支付 功能 的 手机 就 可 以 行 遍 全 国 : 他 们 的 手机 可 以 用 作 机 场 登 机 验证 、 
大 厦 的 门禁 钥匙 、 交 通 一 卡通 、 信 用 卡 、 支 付 卡 等 。 

NFC 和 蓝牙 都 是 短程 通信 技术 ， 而 且 都 被 集成 到 移动 电话 ， 但 NFC 不 需要 复杂 的 设置 程序 。NFC 
也 可 以 简化 蓝牙 连接 。NFC 略 胜 蓝 牙 的 地 方 在 于 设置 程序 较 短 , 但 无 法 达到 低 功 率 蓝牙 (Bluetooth Low 
Energy) 的 速度 。 在 两 台 МЕС 设备 相互 连接 的 设备 识别 过 程 中 , 使 用 NFC 来 替代 人 工 设 置 会 使 创建 连 
接 的 速度 大 大 加 快 ， 会 少 于 十 分 之 一 秒 。 
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BLE 是 Bluetooth Low Energy 的 缩写 ， 意 为 低 功 耗 蓝 牙 ， 是 对 传统 蓝牙 BR/EDR 技术 的 补充 。 尽 
E BLE 和 传统 蓝牙 都 被 称 为 蓝牙 标准 ， 并 且 都 共享 射频 ， 但 是 BLE 是 一 个 完全 不 一 样 的 技术 。BLE 
不 具备 和 传统 蓝牙 BR/EDR 的 兼容 性 ， 是 专 为 小 数据 率 、 离 散 传输 的 应 用 而 设计 的 。 本 节 将 详细 讲解 


低 功 耗 蓝牙 技术 的 基本 知识 。 


ой 外 设 开发 实战 


6.2.1 低 功 耗 蓝牙 的 架构 


BLE 协议 架构 总 体 上 分 成 3 层 , 从 下 到 上 分 别 是 : 控制 器 (Controller)、 主机 (Host) 和 应 用 端 (Apps)。 
三 者 可 以 在 同一 芯片 类 实现 ， 也 可 以 分 不 同 芯片 内 实现 ， 控 制 器 〈Controller) 是 处 理 射频 数据 解析 、 接 
KARZ, EH Host) 是 控制 不 同 设备 之 间 如 何 进行 数据 交换 ;应 用 端 (Apps) 实现 具体 应 用 。 

(1) 控制 器 Controller 

Controller 实现 射频 相关 的 模拟 和 数字 部 分 ,完成 最 基本 的 数据 发 送 和 接收 ，Controller 对 外 接口 是 
天 线 ， 对 内 接口 是 主机 控制 器 接口 HCI (Host Controller Interface); 控制 器 包含 物理 层 PHY (Physical 
Layer)、 链 路 层 LL (Linker Layer)、 直 接 测 试 模式 DTM (Direct Test Mode) 以 及 主机 控制 器 接口 HCI。 

口 物理 层 PHY 

GFSK 信号 调制 ，2402MHz~2480MHz，40 个 channel， 每 两 个 channel 间隔 2MHz (经 典 蓝牙 协议 
是 1MHz)， 数 据 传输 速率 是 1Mbps。 

口 直接 测试 模式 DTM 

为 射频 物理 层 测试 接口 ， 射 频数 据 分 析 之 用 。 

口 链 路 层 LL 

基于 物理 层 PHY 之 上 ， 实 现 数 据 通 道 分 发 、 状 态 切换 、 数 据 包 校 验 和 加 密 等 ， 链 路 层 LL 分 2 种 
通道 : 广播 通道 (advertising channels) 和 数据 通道 (data channels); 广播 通道 有 3 个 , 37ch (2402MHz)， 
38ch (2426MHz), 39ch (2480MHz)， 每 次 广播 都 会 往 这 3 个 通道 同时 发 送 〈 并 不 会 在 这 3 个 通道 之 
间 跳 频 )， 为 防止 某 个 通道 被 其 他 设备 阻塞 ， 以 至 于 设备 无 法 配对 或 广播 数据 ， 之 所 以 定 3 个 广播 通道 
是 一 种 权衡 ， 少 了 可 能 会 被 阻塞 ， 多 了 加 大 功 耗 ， 还 有 一 个 有 意思 的 事情 是 ，3 个 广播 通道 刚好 避 开 了 
WiFi 的 lch、6ch、1lch， 所 以 在 BLE 广播 的 时 候 ， 不 至 于 被 WiFi 影响 ， 当 BLE 匹配 之 后 ， 链 路 层 
LL 由 广播 通道 切换 到 数据 通道 ， 数 据 通道 37 个 ， 数 据 传输 的 时 候 会 在 这 37 个 通道 间 切 换 ， 切 换 规 则 
在 设备 问 匹配 时 候 约 定 。 

(2) 主机 Host/ 控 制 器 Controller 接口 HCI 

HCI 作为 一 种 接口 ， 存 在 于 主机 Host 和 控制 器 Controller 中 ,控制 器 Host 通过 НСІ 发 送 数据 和 事 
件 给 主机 ， 主 机 Host 通过 HCI 发 送 命令 和 数据 给 控制 器 Controller. HCI 逻辑 上 定义 一 系列 的 命令 、 事 
件 ; 物理 上 有 UART、SDIO、USB， 实 际 可 能 包含 里 面 的 任意 一 种 或 几 种 。 


6.2.2” 低 功 耗 蓝 牙 分 类 


BLE 通常 应 用 在 传感器 和 智能 手机 或 者 平板 的 通信 中 。 到 目前 为 止 ， 只 有 很 少 的 智能 机 和 平板 支 
持 BLE， 如 iPhone 4S 以 后 的 苹果 手机 、Motorola Razr 和 the new iPad 及 其 以 后 的 Pad。 安 卓 手机 也 逐 
渐 支 持 BLE， 安 卓 的 BLE 标准 在 2013 年 7 月 24 日 刚 发 布 。 智 能 机 和 平板 会 带 双 模 蓝 牙 的 基带 和 协议 
栈 ， 协 议 栈 中 包括 GATT 及 以 下 的 所 有 部 分 ， 但 是 没有 GATT 之 上 的 具体 协议 。 所 以 ， 这 些 具体 的 协 
议 需要 在 应 用 程序 中 实现 ， 实 现时 需要 基于 各 个 САТТ API 集 。 这 样 有 利于 在 智能 机 端 简单 地 实现 具 
体 协议 ， 也 可 以 在 智能 机 端 简单 地 开发 出 一 套 基 于 GATT 的 私有 协议 。 

在 现实 应 用 中 ， 低 功 耗 蓝牙 分 为 单 模 (Bluetooth Smart) 和 双 模 (Bluetooth Smart Ready) 两 种 设 
备 。BLE 和 蓝牙 BR/EDR 有 所 区 分 ， 这 样 可 以 让 我 们 用 3 种 方式 将 蓝牙 技术 集成 到 具体 设备 中 。 因 为 
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不 再 是 所 有 现 有 的 蓝牙 设备 可 以 和 另 一 个 蓝牙 设备 进行 互联 ， 所 以 准确 描述 产品 中 蓝牙 的 版 本 是 非常 
重要 的 。 在 接 下 来 的 内 容 中 ， 将 详细 讲解 单 模 蓝牙 和 双 模 蓝 牙 的 基本 知识 。 

(1) 单 模 蓝牙 

单 模 蓝 牙 设备 被 称 为 Bluetooth Smart 设备 ， 并 且 有 专用 的 Logo， 如 图 6-1 所 示 。 

在 现实 应 用 中 ， 手 表 、 运 动 传感器 等 小 型 设备 通常 是 基于 低 功 耗 单 模 蓝牙 的 。 为 了 实现 极 低 的 功 
耗 效果 ， 在 硬件 和 软件 上 都 进行 了 优化 ， 这 样 的 设备 只 能 支持 BLE。 单 模 蓝牙 芯片 往往 是 一 个 带 有 单 
模 蓝 牙 协 议 栈 的 产品 ， 这 个 协议 栈 通常 是 芯片 商 免费 提供 的 。 

(2) 双 模 蓝牙 
双 模 蓝牙 设备 被 称 为 Bluetooth Smart Ready 设备 ， 并 且 有 专用 的 Logo, MI 6-2 所 示 。 
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SMART SMART READY 
图 6-1 Bluetooth Smart 设备 6-2 Bluetooth Smart Ready 设备 
双 模 设备 支持 蓝牙 BR/EDR 和 BLE。 在 双 模 设备 中 ，BR/EDR 和 BLE 技术 使 用 同一 个 射频 前 端 和 
天 线 。 典 型 的 双 模 设备 有 智能 手机 、 平 板 电脑 、PC 和 Gateway。 这 些 设备 可 以 接收 到 通过 BLE 或 者 蓝 
F BR/EDR 设备 发 送 过 来 的 数据 ， 这 些 设备 往往 都 有 足够 的 供电 能 力 。 双 模 设 备 和 BLE 设备 通信 的 功 
耗 低 于 双 模 设备 和 蓝牙 BR/EDR 设备 通信 的 功 耗 。 在 使 用 双 模 解决 方案 时 ， 需 要 用 一 个 外 部 处 理 器 才 
可 以 实现 蓝牙 协议 栈 。 


6.23 BLE 和 传统 蓝牙 BR/EDR 技术 的 对 比 


BLE 和 传统 蓝牙 BR/EDR 技术 相 比 的 细节 如 表 6-1 所 示 。 
56-1 BLE 和 传统 蓝牙 BRIEDR 技术 的 对 比 


对 比 Bluetooth BR/EDR Bluetooth Low Enei 
Frequency 2400 ~2483.5 MHz 2400~2483.5 MHz 
Deep Sleep ~80 uA <5 pA 
Idle ~8 mA -] mA 


Peak Current 6~40 mA 10~30 mA 
500m (Class 1) / 50m (Class 2) 
Min. Output Power 0 dBm (Class 1) / -6 dBm (Class 2) 
Max. Output Power +20 dBm (Class 1) / +4 dBm (Class 2) 


Range 


+10 dBm 


Receiver Sensitivit 2 -70 dBm => -70 dBm 
Encryption 64 bit / 128 bit AES-128 bit 
Connection Time 100 ms 3 ms 
Frequency Hopping Yes Yes 
Advertising Channel 32 3 

Data Channel 79 37 

Voice Capable Yes No 
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Android 平 台 的 蓝牙 系统 是 基于 Bluez 实现 的 ,是 通过 Linux 中 一 套 完整 的 蓝牙 协议 栈 开源 实现 的 。 
当前 Bluez 被 广泛 应 用 于 各 种 Linux 版 本 中 , 并 被 芯片 公司 移植 到 各 种 芯片 平台 上 所 使 用 。 在 Linux 2.6 
内 核 中 已 经 包含 了 完整 的 BlueZ WNR, E Android 系统 中 已 经 移植 并 嵌入 进 了 Bluez 的 用 户 空间 实 
现 ， 并 且 随 着 硬件 技术 的 发 展 而 不 断 更 新 。 

WA (Bluetooth) 技术 实际 上 是 一 种 短 距离 无 线 电 技术 。 在 Android 系统 的 蓝牙 模块 中 ， 除 了 使 
用 Kernel 支持 外 ， 还 需要 用 户 空间 的 Bluez 的 支持 。 

Android 平台 中 蓝牙 模块 的 基本 层次 结构 如 图 6-3 所 示 。 


蓝牙 应 用 平台 API 


本 地 框架 
Android.bluetooth 包 
Ny Android 系 统 
本 地 框架 | Bluetooth JNI 
bluetooth 适 配 层 和 BlueZ 库 
蓝牙 设备 硬件 和 驱动 


63 蓝牙 系统 的 层次 结构 


Android 平台 中 蓝牙 系统 从 上 到 下 主要 包括 Java 框架 中 的 BlueTooth 类 、Android 适 配 库 、BlueZ 
库 、 驱 动 程序 和 协议 ， 这 几 部 分 的 系统 结构 如 图 6-4 所 示 。 


android,bluetooth 包 
中 的 各 个 类 
javali E 


用 户 空间 


内 核 空间 
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$65 蓝牙 系统 详解 


在 图 6-4 中 各 个 层次 结构 的 具体 说 明 如 下 。 
(1) BlueZ 库 
Android 蓝牙 设备 管理 的 库 的 路 径 如 下 所 示 。 
external/bluez/ 
可 以 分 别 生成 库 libbluetooth.so. libbluedroid.so 和 hcidump 等 众多 相关 工具 和 库 。BlueZ 库 提 供 了 
对 用 户 空间 蓝牙 的 支持 ， 在 里 面包 含 了 主机 控制 协议 HCI 以 及 其 他 众多 内 核实 现 协议 的 接口 ， 并 且 实 
现 了 所 有 蓝牙 应 用 模式 Profile. 
(2) 蓝牙 的 JNI 部 分 
此 部 分 的 代码 路 径 如 下 所 示 。 
frameworks/base/core/jni/ 
(3) Java 框架 层 


Java 框架 层 的 实现 代码 保存 在 如 下 路 径 。 
frameworks/base/core/java/android/bluetooth // 蓝 牙 部 分 对 应 应 用 程序 的 API 
frameworks/base/core/java/android/Server // 蓝 牙 的 服务 部 分 


蓝牙 的 服务 部 分 负责 管理 并 使 用 底层 本 地 服务 , 并 封装 成 系统 服务 。 而 在 android.bluetooth 部 分 中 
包含 了 各 个 蓝牙 平台 的 API 部 分 ， 以 供应 用 程序 层 所 使 用 。 
(4) BlueTooth 的 适 配 库 
BlueTooth 适 配 库 的 代码 路 径 如 下 所 示 。 
system/bluetooth/ 
在 此 层 用 于 生成 库 libbluedroid.so 以 及 相关 工具 和 库 ， 能够 实现 对 蓝牙 设备 的 管理 ,例如 蓝牙 设备 


的 电源 管理 。 
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经 过 本 章 前 面 内 容 的 学 习 ， 读 者 已 经 了 解 了 Android 系统 中 蓝牙 的 基本 知识 ， 根 据 对 上 述 从 底层 
到 应 用 的 学 习 ， 了 解 了 蓝牙 的 工作 原理 和 机 制 。 本 节 将 详细 讲解 在 Android 系统 中 和 蓝牙 相关 的 类 ， 
为 读者 学 习 本 书后 面 的 知识 打 好 基础 。 


6.4.1 BluetoothSocket 类 


1. BluetoothSocket 类 基础 


BluetoothSocket 类 的 定义 格式 如 下 所 示 。 
public static class Gallery.LayoutParams extends ViewGroup.LayoutParams 


BluetoothSocket 类 的 定义 结构 如 下 所 示 。 


java.lang.Object 
android.view. ViewGroup.LayoutParams 
android.widget.Gallery.LayoutParams 


Android 的 蓝牙 系统 和 Socket 套 接 字 密切 相关 ， 蓝 牙 端 的 监听 接口 和 TCP 的 端口 类 似 ， 都 是 使 用 
了 Socket 和 ServerSocket 类 。 在 服务 器 端 ， 使 用 BluetoothServerSocket 类 来 创建 一 个 监听 服务 端口 。 
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当 一 个 连接 被 BluetoothServerSocket 所 接受 ， 它 会 返回 一 个 新 的 BluetoothSocket 来 管理 该 连接 。 在 客 
户 端 ， 使 用 一 个 单独 的 BluetoothSocket 类 去 初始 化 一 个 外 接连 接 和 管理 该 连接 。 

最 通常 使 用 的 蓝牙 端口 是 RFCOMM， 它 是 被 Android API 支持 的 类 型 。 RFCOMM 是 一 个 面向 连 
接 ， 通 过 蓝牙 模块 进行 的 数据 流传 输 方 式 ， 也 被 称 为 串 行 端 口 规范 (Serial Port Profile, SPP). 

为 了 创建 一 个 BluetoothSocket 去 连接 到 一 个 已 知 设备 ， 使 用 方法 BluetoothDevice.createRfcomm 
SocketToServiceRecord()。 然 后 调用 connect0 方 法 去 尝试 一 个 面向 远程 设备 的 连接 。 这 个 调用 将 被 阻塞 
直到 一 个 连接 已 经 建立 或 者 该 连接 失效 。 

为 了 创建 一 个 BluetoothSocket 作为 服务 端 (或 者 “主机 ”)， 每 当 该 端口 连接 成 功 后 ， 无 论 它 初始 
化 为 客户 端 , 或 者 被 接受 作为 服务 器 端 , 都 通过 方法 getInputStream() 和 getOutputStream() 来 打开 VO 流 ， 
从 而 获得 各 自 的 InputStream 和 OutputStream 对 象 。 

BluetoothSocket 类 的 线程 是 安全 的 ， 因 为 close() 方 法 总 会 马上 放弃 外 界 操 作 并 关闭 服务 器 端口 。 


2. BluetoothSocket 类 的 公共 方法 


(1) public void close () 

功能 : 马上 关闭 该 端口 并 且 释 放 所 有 相关 的 资源 。 在 其 他 线程 的 该 端口 中 引起 阻塞 ， 从 而 使 系统 
马上 抛 出 一 个 VO 异常 。 

异常 : IOException。 

(2) public void connect () 

功能 : 尝试 连接 到 远程 设备 。 该 方法 将 阻塞 ， 指 导 一 个 连接 建立 或 者 失效 。 如 果 该 方法 没有 返回 
异常 值 ， 则 该 端口 现在 已 经 建立 。 当 设备 查找 正在 进行 的 时 候 ， 创 建 对 远程 蓝牙 设备 的 新 连接 不 可 被 
尝试 。 设 备查 找 在 蓝牙 适配器 上 是 一 个 重量 级 过 程 ， 并 且 肯 定 会 降低 一 个 设备 的 连接 。 使 用 
cancelDiscovery() 方 法 会 取消 一 个 外 界 的 查询 ， 因 为 这 个 查询 并 不 由 活动 所 管理 ， 而 是 作为 一 个 系统 服 
务 来 运行 ， 所 以 即使 它 不 能 直接 请 求 一 个 查询 ， 应 用 程序 也 总 会 调用 cancelDiscovery() 方 法 。 使 用 方法 
close() 可 以 用 来 放弃 从 另 一 线程 而 来 的 调用 。 

异常 : IOException， 表 示 一 个 错误 ， 例 如 连接 失败 。 

(3) public InputStream getInputStream () 

功能 : 通过 连接 的 端口 获得 输入 数据 流 。 即 使 该 端口 未 连接 ， 该 输入 数据 流 也 会 返回 。 不 过 在 该 
数据 流 上 的 操作 将 抛 出 异常 ， 直 到 相关 的 连接 已 经 建立 。 

返回 值 : 输入 流 。 

异常 : IOException. 

(4) public OutputStream getOutputStream () 

功能 : 通过 连接 的 端口 获得 输出 数据 流 。 即 使 该 端口 未 连接 ， 该 输出 数据 流 也 会 返回 。 不 过 在 该 
数据 流 上 的 操作 将 抛 出 异常 ， 直 到 相关 的 连接 已 经 建立 。 

返回 值 : 输出 流 。 

异常 : IOException。 

(5) public BluetoothDevice getRemoteDevice () 

功能 : 获得 该 端口 正在 连接 或 者 已 经 连接 的 远程 设备 。 

返回 值 : 远程 设备 。 
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6.4.2 BluetoothServerSocket 类 


1. BluetoothServerSocket 类 基础 


BluetoothServerSocket 类 的 格式 如 下 所 示 。 

public final class BluetoothServerSocket extends Object implements Closeable 
BluetoothServerSocket 类 的 结构 如 下 所 示 。 

java.lang.Object 

android. bluetooth.BluetoothServerSocket 


2. BluetoothServerSocket 类 的 公共 方法 


(1) public BluetoothSocketaccept (int timeout) 
功能 : 阻塞 直到 超时 时 间 内 的 连接 建立 。 在 一 个 成 功 建立 的 连接 上 返回 一 个 已 连接 的 
BluetoothSocket 类 。 每 当 该 调用 返回 的 时 候 ， 它 可 以 在 此 调用 去 接收 以 后 新 来 的 连接 。close() 方 法 可 以 
用 来 放弃 从 另 一 线程 来 的 调用 。 
参数 timeout: 表示 阻塞 超时 时 间 。 
返回 值 : 已 连接 的 BluetoothSocket。 
异常 : IOException， 表 示 出 现 错误 ， 比 如 该 调用 被 放弃 或 超时 。 
(2) public BluetoothSocket accept () 
功能 : 阻塞 直到 一 个 连接 已 经 建立 。 在 一 个 成 功 建立 的 连接 上 返回 一 个 已 连接 的 BluetoothSocket 
类 。 每 当 该 调用 返回 的 时 候 ， 它 可 以 在 此 调用 去 接收 以 后 新 来 的 连接 。 使 用 close() 方 法 可 以 用 来 放弃 
从 另 一 线程 来 的 调用 。 
返回 值 : 已 连接 的 BluetoothSocket。 
异常 : IOException， 表 示 出 现 错误 ， 比 如 该 调用 被 放弃 或 者 超时 。 
(3) public void close () 
功能 : 马上 关闭 端口 ， 并 释放 所 有 相关 的 资源 。 在 其 他 线程 的 该 端口 中 引起 阻塞 ， 从 而 使 系统 马 
上 抛 出 一 个 VO 异常。 关闭 BluetoothServerSocket 不 会 关闭 接受 自 accept() 的 任意 BluetoothSocket. 
异常 : IOException. 


6.4.3 BluetoothAdapter 类 


1. BluetoothAdapter 类 基础 


Bluetooth Adapter 类 的 格式 如 下 所 示 。 

public final class BluetoothAdapter extends Object 
BluetoothAdapter 类 的 结构 如 下 所 示 。 
java.lang.Object 
android.bluetooth.BluetoothAdapter 


BluetoothAdapter 代表 本 地 的 蓝牙 适配器 设备 ， 通 过 此 类 可 以 让 用 户 能 执行 基本 的 蓝牙 任务 。 例 如 
初始 化 设备 的 搜索 ， 查 询 可 匹配 的 设备 集 ， 使 用 一 个 已 知 的 MAC 地 址 来 初始 化 一 个 BluetoothDevice 
类 ， 创 建 一 个 BluetoothServerSocket 类 以 监听 其 他 设备 对 本 机 的 连接 请 求 等 。 

P 


为 了 得 到 这 个 代表 本 地 蓝牙 适配器 的 BluetoothAdapter Ж, 需要 调用 静态 方法 getDefaultAdapter()， 
这 是 所 有 蓝牙 动作 使 用 的 第 一 步 。 当 拥有 本 地 适配器 以 后 ， 用 户 可 以 获得 一 系列 的 BluetoothDevice 对 
象 ， 这 些 对 象 代表 所 有 拥有 getBondedDevice() 方 法 的 已 经 匹配 的 设备 ; 用 startDiscovery() 方 法 来 开始 
设备 的 搜寻 ; 或 者 创建 一 个 BluetoothServerSocket 类 , 通过 listenUsingRfcommWithServiceRecord(String, 
UUID) 方 法 来 监听 新 来 的 连接 请 求 。 


注意 : 大 部 分 方法 需要 BLUETOOTH 权 限 ， 一 些 方法 同时 需要 BLUETOOTH ADMIN 权 限 。 
2. BluetoothAdapter 类 的 常量 


(1) String ACTION_DISCOVERY_FINISHED 
广播 事件 ， 本 地 蓝牙 适配器 已 经 完成 设备 的 搜寻 过 程 ， 需 要 BLUETOOTH 权限 接收 。 
常量 值 : android.bluetooth.adapteraction.DISCOVERY FINISHED. 
(2) String ACTION_DISCOVERY_STARTED 
广播 事件 : 本 地 蓝牙 适配器 已 经 开始 对 远程 设备 的 搜寻 过 程 。 它 通常 涉及 一 个 大 概 需 时 12 秒 的 查 
询 扫描 过 程 ， 紧 跟着 是 一 个 对 每 个 获取 到 自身 蓝牙 名 称 的 新 设备 的 页 面 扫描 。 用 户 会 发 现 一 个 把 
ACTION_FOUND 常量 通知 为 远程 蓝牙 设备 的 注册 。 设 备查 找 是 一 个 重量 级 过 程 。 当 查找 正在 进行 的 
时 候 ， 用 户 不 能 尝试 对 新 的 远程 蓝牙 设备 进行 连接 ， 同 时 存在 的 连接 将 获得 有 限制 的 带宽 以 及 高 等 待 
时 间 。 用 户 可 用 cancelDiscovery() 方 法 来 取消 正在 执行 的 查找 进程 ， 需 要 BLUETOOTH 权限 接收 。 
常量 值 ，android.bluetooth.adapter.action.DISCOVERY_STARTED。 
(3) String ACTION LOCAL NAME CHANGED 
广播 活动 : 本 地 蓝牙 适配器 已 经 更 改 了 它 的 蓝牙 名 称 。 该 名 称 对 远程 蓝牙 设备 是 可 见 的 ， 它 总 是 
包含 一 个 带 有 名 称 的 EXTRA_LOCAL_NAME 附加 域 ， 需 要 BLUETOOTH 权限 接收 。 
常量 值 : android.bluetooth.adapter.action.LOCAL МАМЕ CHANGED. 
(4) String ACTION REQUEST. DISCOVERABLE 
Activity 活动 : 显示 一 个 请 求 被 搜寻 模式 的 系统 活动 。 如 果 蓝 牙 模 块 当前 未 打开 ， 该 活动 也 将 请 求 
用 户 打开 蓝牙 模块 。 被 搜寻 模式 和 SCAN MODE CONNECTABLE DISCOVERABLE 等 价 。 当 远程 设 
备 执行 查找 进程 的 时 候 ， 它 允许 其 发 现 该 蓝牙 适配器 。 从 隐私 安全 考虑 ，Android 不 会 将 被 搜寻 模式 设 
置 为 默认 状态 。 该 意图 的 发 送 者 可 以 选择 性 地 运用 EXTRA_DISCOVERABLE_DURATION 这 个 附加 域 
去 请 求 发 现 设备 的 持续 时 间 。 普 遍 来 说 ， 对 于 每 一 请 求 ， 默 认 的 持续 时 间 为 120 秒 ， 最 大 值 则 可 达到 
300 秒 。 
Android 运用 onActivityResult(int, int, Intent) 回 收 方法 来 传递 该 活动 结果 的 通知 。 被 搜寻 的 时 间 ( 以 
秒 为 单位 ) 将 通过 resultCode 值 来 显示 , 如 果 用 户 拒绝 被 搜寻 , 或 者 设备 产生 了 错误 , 则 通过 RESULT_ 
CANCELED 值 来 显示 。 
每 当 扫描 模式 变化 的 时 候 ， 应 用 程序 可 以 为 通过 ACTION SCAN MODE CHANGED 值 来 监听 全 
局 的 消息 通知 。 比 如, 当 设 备 停止 被 搜寻 以 后 ,该 消息 可 以 被 系统 通知 给 应 用 程序 。 需 要 BLUETOOTH 
权限 。 
常量 值 : android.bluetooth.adapter.action.REQUEST_DISCOVERABLE。 
(5) String ACTION_REQUEST_ENABLE 
Activity 活动 : 显示 一 个 允许 用 户 打开 蓝牙 模块 的 系统 活动 。 当 蓝牙 模块 完成 打开 工作 ， 或 者 当 用 
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户 决定 不 打开 蓝牙 模块 时 ， 系 统 活 动 将 返回 该 值 。Android 运用 onActivityResult(int, int, Intent) 回 收 方 
法 来 传递 该 活动 结果 的 通知 。 如 果 蓝 牙 模块 被 打开 ， 将 通过 resultCode 值 RESULT. OK 来 显示 ; WMA 
用 户 拒绝 该 请 求 ， 或 者 设备 产生 了 错误 ， 则 通过 RESULT_CANCELED 值 来 显示 。 每 当 蓝牙 模块 被 打 
开 或 者 关闭 ， 应 用 程序 可 以 为 通过 ACTION STATE CHANGED 值 来 监听 全 局 的 消息 通知 。 需 要 
BLUETOOTH 权限 。 
常量 值 : android.bluetooth.adapter.action.REQUEST_ENABLE。 
(6) String ACTION SCAN MODE CHANGED 
广播 活动 : 指明 蓝牙 扫描 模块 或 者 本 地 适配器 已 经 发 生变 化 。 它 总 是 包含 EXTRA SCAN MODE 
和 EXTRA PREVIOUS SCAN MODE。 这 两 个 附加 域 各 自 包含 了 新 的 和 旧 的 扫描 模式 。 需 要 
BLUETOOTH 权限 。 
常量 值 : android.bluetooth.adapteraction.SCAN_MODE CHANGED. 
(7) String ACTION_STATE_CHANGED 
广播 活动 : 本 来 的 蓝牙 适配器 的 状态 已 经 改变 ， 例 如 蓝牙 模块 已 经 被 打开 或 者 关闭 。 它 总 是 包含 
EXTRA STATE 和 EXTRA_PREVIOUS_STATE。 这 两 个 附加 域 各 自 包含 了 新 的 和 旧 的 状态 。 需 要 
BLUETOOTH 权限 接收 。 
常量 值 ，android.bluetooth.adapter.action.STATE_CHANGED。 
(8) int ERROR 
功能 : 标记 该 类 的 错误 值 。 确 保 和 该 类 中 的 任意 其 他 整数 常量 不 相等 。 它 为 需要 一 个 标记 错误 值 
的 函数 提供 了 便利 。 例 如 : 
Intent.getIntExtra(BluetoothAdapter.EXTRA_STATE, BluetoothAdapter.ERROR) 
常量 值 ， -2147483648 (0х80000000). 
(9) String EXTRA_DISCOVERABLE_DURATION 
功能 : 试图 在 ACTION REQUEST. DISCOVERABLE 常量 中 作为 一 个 可 选 的 整 型 附加 域 ， 来 为 短 
时 间 内 的 设备 发 现 请 求 一 个 特定 的 持续 时 间 。 默 认 值 为 120 秒 ， 超 过 300 秒 的 请 求 将 被 限制 。 这 些 值 
是 可 以 变化 的 。 
常量 值 : android.bluetooth.adapter.extra.DISCOVERABLE DURATION. 
(10) String EXTRA_LOCAL NAME 
ЭЁ: 试图 在 ACTION LOCAL NAME CHANGED 常量 中 作为 一 个 字符 串 附 加 域 ， 来 请 求 本 地 
蓝牙 的 名 称 。 
常量 值 : android.bluetooth.adapter.extraLOCAL МАМЕ. 
(11) String EXTRA_PREVIOUS_SCAN_MODE 
功能 : 试图 在 ACTION SCAN MODE CHANGED 常量 中 作为 一 个 整 型 附加 域 ， 来 请 求 以 前 的 扫 
描 模式 。 可 能 值 包括 : 
口 SCAN MODE NONE 
Q SCAN MODE CONNECTABLE 
Q SCAN MODE CONNECTABLE DISCOVERABLE 
WAB: android.bluetooth.adapter.extra. PREVIOUS SCAN MODE. 
(12) String EXTRA PREVIOUS STATE 
功能 : 试图 在 ACTION STATE CHANGED 常量 中 作为 一 个 整 型 附加 域 , 来 请 求 以 前 的 供电 状态 。 
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可 以 取得 值 如 下 。 

Q STATE OFF 

Q STATE TURNING ON 

Q STATE ON 

Q STATE TURNING OFF 

常量 值 : android.bluetooth.adapter.extra.PREVIOUS STATE. 

(13) String EXTRA_SCAN MODE 

功能 : 试图 在 ACTION SCAN MODE CHANGED 常量 中 作为 一 个 整 型 附加 域 ， 来 请 求 当前 的 扫 
描 模式 ， 可 以 取得 值 如 下 。 

口 SCAN_MODE NONE 

口 SCAN MODE CONNECTABLE 

Q SCAN MODE CONNECTABLE DISCOVERABLE 

ЖОНО: android.bluetooth.adapter.extra.SSCAN MODE. 

(14) String EXTRA STATE 

功能 : 试图 在 ACTION STATE CHANGED 常量 中 作为 一 个 整 型 附加 域 , 来 请 求 当前 的 供电 状态 。 
可 以 取得 值 如 下 。 

口 STATE OFF 

О STATE TURNING ON 

О STATE ON 

Q STATE TURNING OFF 

Tí: android.bluetooth.adapter.extra.STATE 

(15) int SCAN MODE CONNECTABLE 

功能 :指明 在 本 地 蓝牙 适配器 中 ， 查 询 扫描 功能 失效 ， 但 页 面 扫描 功能 有 效 。 因 此 该 设备 不 能 被 
远程 蓝牙 设备 发 现 ， 但 如 果 以 前 曾经 发 现 过 该 设备 ， 则 远程 设备 可 以 对 其 进行 连接 。 

常量 值 ， 21 (0x00000015). 

(16) int SCAN_MODE_CONNECTABLE_DISCOVERABLE 

ЭЁ: 指明 在 本 地 蓝牙 适配器 中 ， 查 询 扫 描 功能 和 页 面 扫描 功能 都 有 效 。 因 此 该 设备 既 可 以 被 远 
程 蓝牙 设备 发 现 ， 也 可 以 被 其 连接 。 

常量 值 : 23 (0x00000017). 

(17) int SCAN MODE NONE 

功能 : 指明 在 本 地 蓝牙 适配器 中 ， 查 询 扫描 功能 和 页 面 扫描 功能 都 失效 。 因 此 该 设备 既 不 可 以 被 
远程 蓝牙 设备 发 现 ， 也 不 可 以 被 其 连接 。 

常量 值 : 20 (0x00000014). 

(18) int STATE_OFF 

功能 : 指明 本 地 蓝牙 适配器 模块 已 经 关闭 。 

常量 值 : 10 (0x0000000a)。 

(19) int STATE_ON 

功能 : 指明 本 地 蓝牙 适配器 模块 已 经 打开 ， 并 且 准备 被 使 用 。 
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(20) int STATE_TURNING_OFF 

功能 : 指明 本 地 蓝牙 适配器 模块 正在 关闭 。 本 地 客户 端 可 以 立刻 尝试 友好 地 断 开 任意 外 部 连接 。 

常量 值 : 13 (0x0000000d). 

(21) int STATE_TURNING_ON 

功能 : 指明 本 地 蓝牙 适配器 模块 正在 打开 ， 然 而 本 地 客户 在 尝试 使 用 这 个 适配器 之 前 需要 为 
STATE ON 状态 而 等 待 。 

常量 值 : 11 (0x0000000b)。 


3. BluetoothAdapter 类 的 公共 方法 


(1) public boolean cancelDiscovery () 

功能 : 取消 当前 的 设备 发 现 查找 进程 需要 BLUETOOTH ADMIN 权限 。 因 为 对 蓝牙 适配器 而 言 ， 
查找 是 一 个 重量 级 的 过 程 ， 因 此 这 个 方法 必须 在 尝试 连接 到 远程 设备 前 使 用 connect() 方 法 进行 调用 。 
发 现 的 过 程 不 会 由 活动 来 进行 管理 ， 但 是 它 会 作为 一 个 系统 服务 来 运行 ， 因 此 即使 它 不 能 直接 请 求 这 
样 的 一 个 查询 动作 ， 也 必须 取消 该 搜索 进程 。 如 果 蓝 牙 状态 不 是 STATE ON， 这 个 API 将 返回 false. 
蓝牙 打开 后 ， 等 待 ACTION STATE CHANGED 更 新 成 STATE_ON。 

返回 值 : 成 功 则 返回 tue， 错 误 则 返回 false. 

(2) public static boolean checkBluetoothAddress (String address) 

功能 : 验证 缘 如 "00:43:A8:23:10:F0" 之 类 的 蓝牙 地 址 ， 字 母 必须 为 大 写 才 有 效 。 

BR address: 字符 串 形式 的 蓝牙 模块 地 址 。 

返回 值 : 地 址 正确 则 返回 true, FURE false. 

(3) public boolean disable 0 

功能 : 关闭 本 地 蓝牙 适配器 一 一 不 能 在 没有 明确 关闭 蓝牙 的 用 户 动作 中 使 用 。 这 个 方法 友好 地 停 
止 所 有 的 蓝牙 连接 ， 停 止 蓝牙 系统 服务 ， 以 及 对 所 有 基础 蓝牙 硬件 进行 断 电 。 没 有 用 户 的 直接 同意 ， 
蓝牙 不 能 永远 被 禁止 。 这 个 disable0 方 法 只 提供 了 一 个 应 用 , 该 应 用 包含 了 一 个 改变 系统 设置 的 用 户 界 
面 (例如 “电源 控制 ”应 用 )。 

这 是 一 个 异步 调用 方法 : 该 方法 将 马上 获得 返回 值 , 用 户 要 通过 监听 ACTION_STATE_CHANGED 
值 来 获取 随后 的 适配器 状态 改变 的 通知 。 如 果 该 调用 返回 true f, 则 该 适配器 状态 会 立刻 从 STATE, ON 
转向 STATE TURNING OFF, 稍 后 则 会 转 为 STATE OFF 或 者 STATE_ON。 如 果 该 调用 返回 false, JJ: 
么 系统 已 经 有 一 个 保护 蓝牙 适配器 被 关闭 的 问题 ， 比 如 该 适配器 已 经 被 关闭 了 。 

需要 BLUETOOTH_ADMIN 权限 。 

返回 值 : 如 果 蓝 牙 适 配器 的 停止 进程 已 经 开启 则 返回 tue， 如 果 产 生 错误 则 返回 false. 

(4) public boolean enable () 

功能 : 打开 本 地 蓝牙 适配器 一 一 不 能 在 没有 明确 打开 蓝牙 的 用 户 动作 中 使 用 。 该 方法 将 为 基础 的 
蓝牙 硬件 供电 ， 并 且 启 动 所 有 的 蓝牙 系统 服务 。 没 有 用 户 的 直接 同意 ， 蓝 牙 不 能 永远 被 禁止 。 如 果 用 
户 为 了 创建 无 线 连接 而 打开 了 蓝牙 模块 , 则 其 需要 ACTION REQUEST ENABLE 值 , 该 值 将 提出 一 个 
请 求 用 户 允 许 以 打开 蓝牙 模块 的 会 话 。 这 个 enable() 值 只 提供 了 一 个 应 用 ， 该 应 用 包含 了 一 个 改变 系统 
设置 的 用 户 界面 (如 “电源 控制 ”应 用 )。 

这 是 一 个 异步 调用 方法 : 该 方法 将 马上 获得 返回 值 , 用 户 要 通过 监听 ACTION_STATE_CHANGED 
值 来 获取 随后 的 适配器 状态 改变 的 通知 ,如果 该 调用 返回 true 值 , 则 该 适配器 状态 会 立刻 从 STATE_OFF 
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转向 STATE TURNING_ON， 稍 后 则 会 转 为 STATE OFF 或 者 STATE ON. Aix false, Ж 
么 说 明 系统 已 经 有 一 个 保护 蓝牙 适配器 被 打开 的 问题 ， 比 如 飞行 模式 ， 或 者 该 适配器 已 经 被 打开 。 
ië BLUETOOTH. ADMIN 权限 。 
返回 值 : 如 果 蓝 牙 适 配器 的 打开 进程 已 经 开启 则 返回 tue， 如 果 产 生 错 误 则 返回 false。 
(5) public String getAddress () 
功能 : 返回 本 地 蓝牙 适配器 的 硬件 地 址 。 例 如 : 
00:11:22:AA:BB:CC 
需要 BLUETOOTH 权限 。 
返回 值 : 字符 串 形式 的 蓝牙 模块 地 址 。 
(6) public Set<BluetoothDevice> getBondedDevices () 
功能 : 返回 已 经 匹配 到 本 地 适配器 的 BluetoothDevice 类 的 对 象 集合 。 如 果 蓝 牙 状 态 不 是 
STATE_ON, 这 个 API 将 返回 false。 蓝 牙 打 开 后 ,等 待 ACTION. STATE CHANGED 更 新 成 STATE_ON。 
需要 BLUETOOTH 权限 。 
返回 值 : 未 被 修改 的 BluetoothDevice 类 的 对 象 集合 ， 如 果 有 错误 则 返回 null。 
(7) public static synchronized BluetoothAdapter getDefaultAdapter () 
功能 : 获取 对 默认 本 地 蓝牙 适配器 的 操作 权限 。 目 前 Android 只 支持 一 个 蓝牙 适配器 ， 但 是 API 
可 以 被 扩展 为 支持 多 个 适配器 。 该 方法 总 是 返回 默认 的 适配器 。 
返回 值 : 返回 默认 的 本 地 适配器 ， 如 果 蓝牙 适配器 在 该 硬件 平台 上 不 能 被 支持 ， 则 返回 null. 
(8) public String getName () 
功能 : 获取 本 地 蓝牙 适配器 的 蓝牙 名 称 ， 这 个 名 称 对 于 外 界 蓝牙 设备 而 言 是 可 见 的 。 需 要 
BLUETOOTH 权限 。 
返回 值 :该 蓝牙 适配器 名 称 ， 如 果 有 错误 则 返回 null. 
(9) public BluetoothDevice getRemoteDevice (String address) 
功能 : 为 给 予 的 蓝牙 硬件 地 址 获取 一 个 BluetoothDevice 对 象 。 合 法 的 蓝牙 硬件 地 址 必须 为 大 写 ， 
格式 类 似 于 "00:11:22:33:AA:BB"。checkBluetoothAddress(String) 方 法 可 以 用 来 验证 蓝牙 地 址 的 正确 性 。 
BluetoothDevice 类 对 于 合法 的 硬件 地 址 总 会 产生 返回 值 ， 即 使 这 个 适配器 从 未 见 过 该 设备 。 
参数 : address 合法 的 蓝牙 MAC 地 址 。 
异常 ，IllegalArgumentException， 如 果 地 址 不 合法 。 
(10) public int getScanMode () 
功能 : 获取 本 地 蓝牙 适配器 的 当前 蓝牙 扫描 模式 ， 蓝 牙 扫描 模式 决定 本 地 适配器 可 连接 并 且 / 或 者 
可 被 远程 蓝牙 设备 所 连接 。 需 要 BLUETOOTH 权限 ， 可 能 的 取 值 如 下 。 
Q SCAN MODE NONE 
Q SCAN MODE CONNECTABLE 
Q SCAN MODE CONNECTABLE DISCOVERABLE 
如 果 蓝 牙 状 态 不 是 STATE ON， 则 这 个 API 将 返回 false。 蓝 牙 打 开 后 ， 等 待 ACTION STATE - 
CHANGED 更 新 成 STATE_ON。 
返回 值 : 扫描 模式 。 
(11) public int getState () 
功能 : 获取 本 地 蓝牙 适配器 的 当前 状态 ， 需 要 BLUETOOTH 类 。 可 能 的 取 值 如 下 。 
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О STATE OFF 

D STATE TURNING ON 

Q STATE ON 

О STATE TURNING OFF 

返回 值 : 蓝牙 适配器 的 当前 状态 。 

(12) public boolean isDiscovering () 

功能 : 如果 当前 蓝牙 适配器 正 处 于 设备 发 现 查找 进程 中 ， 则 返回 真 值 。 设 备查 找 是 一 个 重量 级 过 
程 。 当 查找 正在 进行 的 时 候 ， 用 户 不 能 尝试 对 新 的 远程 蓝牙 设备 进行 连接 ， 同 时 存在 的 连接 将 获得 有 
限制 的 带宽 以 及 高 等 待 时 间 。 用 户 可 用 cencelDiscovery() 方 法 来 取消 正在 执行 的 查找 进程 。 
用 程序 也 可 以 为 ACTION DISCOVERY STARTED 或 者 ACTION DISCOVERY FINISHED itt 
行 注册 ， 从 而 当 查 找 开 始 或 者 完成 的 时 候 ， 可 以 获得 通知 。 
如 果 蓝 牙 状 态 不 是 STATE ON， 这 个 API 将 返回 false。 蓝 牙 打 开 后 ， 等 待 ACTION_STATE_ 
CHANGED 更 新 成 STATE ON。 需要 BLUETOOTH 权限 。 

返回 值 : 如 果 正 在 查找 ， 则 返回 true. 

(13) public boolean isEnabled () 

功能 : 如 果 蓝 牙 正 处 于 打开 状态 并 可 用 ， 则 返回 真 值 ， 与 getBluetoothState()==STATE_ON 等 价 需 
要 BLUETOOTH 权限 。 

返回 值 ， 如 果 本 地 适配器 已 经 打开 ， 则 返回 true. 

(14) public BluetoothServerSocket listenUsingRfcommWithServiceRecord (String name, UUID иша) 

功能 : 创建 一 个 正在 监听 的 、 安 全 的 、 带 有 服务 记录 的 无 线 射频 通信 (RFCOMM) 蓝牙 端口 。 一 
个 对 该 端口 进行 连接 的 远程 设备 将 被 认证 ， 对 该 端口 的 通信 将 被 加 密 。 使 用 accpet() 方 法 可 以 获取 从 监 
听 BluetoothServerSocket 处 新 来 的 连接 。 该 系统 分 配 一 个 未 被 使 用 的 无 线 射频 通信 通道 来 进行 监听 。 

该 系统 也 将 注册 一 个 服务 探索 协议 (SDP) 记录 ， 该 记录 带 有 一 个 包含 了 特定 的 通用 唯一 识别 码 
(Universally Unique Identifier, UUID) ， 服 务 器 名 称 和 自动 分 配 通道 的 本 地 SDP 服务 。 远 程 蓝牙 设备 
可 以 用 相同 的 UUD 来 查询 自己 的 SDP 服务 器 ， 并 搜寻 连接 到 了 哪个 通道 上 。 如 果 该 端口 已 经 关闭 ， 
者 该 应 用 程序 异常 退出 , 则 这 个 SDP 记 录 会 被 移 除 。 使 用 createRfcommSocketTo ServiceRecord(UUID) 
可 以 从 另 一 使 用 相同 UUID 的 设备 来 连接 到 这 个 端口 ， 需 要 BLUETOOTH 权限 。 

参数 说 明 如 下 。 

口 name: SDP 记 录 下 的 服务 器 名 。 

口 wid: SDP 记 录 下 的 UUID。 

返回 值 : 一 个 正在 监听 的 无 线 射频 通信 蓝牙 服务 端口 。 

异常 : IOException， 表 示 产 生 错 误 ， 比 如 蓝牙 设备 不 可 用 ， 或 者 许可 无 效 ， 或 者 通道 被 占用 。 

(15) public boolean setName (String name) 

功能 : 设置 蓝牙 或 者 本 地 蓝牙 适配器 的 昵称 ， 这 个 名 字 对 于 外 界 蓝牙 设备 而 言 是 可 见 的 。 合 法 的 
蓝牙 名 称 最 多 拥有 248 位 UTF-8 字符 ， 但 是 很 多 外 界 设备 只 能 显示 前 40 个 字符 ， 有 些 可 能 只 限制 前 
20 个 字符 。 

如 果 蓝 牙 状态 不 是 STATE ON， 这 个 АРІ 将 返回 false。 蓝 牙 打开 后 ， 等 待 ACTION_STATE_ 
CHANGED 更 新 成 STATE ON. #23 BLUETOOTH. ADMIN 权限 。 

® 


Е 


E, 


参数 name: 一 个 合法 的 蓝牙 名 称 。 
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返回 值 : 如 果 该 名 称 已 被 设 定 ， 则 返回 tue， 和 否则 返回 false. 
(16) public boolean startDiscovery () 


功能 : 开始 对 远程 设备 进行 查找 的 进程 ， 它 通常 涉及 一 个 大 概 需 时 12 秒 的 查询 扫描 过 程 ， 紧 跟着 
是 一 个 对 每 个 获取 到 自身 蓝牙 名 称 的 新 设备 的 页 面 扫描 。 这 是 一 个 异步 调用 方法 ;该 方法 将 马上 获得 
返回 值 ， 注 册 ACTION_DISCOVERY_STARTED and ACTION_DISCOVERY_FINISHED 意图 准确 地 确 
定 该 探索 是 处 于 开始 阶段 或 者 完成 阶段 。 注 册 ACTION_FOUND 以 活动 远程 蓝牙 设备 已 找到 的 通知 。 

设备 查找 是 一 个 重量 级 过 程 。 当 查找 正在 进行 的 时 候 ， 用 户 不 能 尝试 对 新 的 远程 蓝牙 设备 进行 连 
接 , 同时 存在 的 连接 将 获得 有 限制 的 带宽 以 及 高 等 待 时 间 。 用 户 可 用 cencelDiscovery() 方 法 来 取消 正在 


执行 的 查找 进程 。 发 现 的 过 程 不 会 由 活动 来 进行 管理 ， 但 是 它 会 作为 一 个 系统 服务 来 运行 ， 
它 不 能 直接 请 求 这 样 的 一 个 查询 动作 ， 也 必须 取消 该 搜索 进程 。 设 备 搜寻 只 寻找 已 经 被 连接 
备 。 许 多 蓝牙 设备 默认 不 会 被 搜寻 到 ， 并 且 需 要 进入 到 一 个 特殊 的 模式 当中 。 
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如 果 蓝 牙 状态 不 是 STATE ON， 这 个 АРІ 将 返回 false。 蓝 牙 打 开 后 ， 等 待 ACTION STATE _ 


CHANGED 更 新 成 STATE ON。 需 要 BLUETOOTH ADMIN 权限 。 
返回 值 : 成功 返回 true， 错 误 返 回 false. 


6.4.4 BluetoothClass.Service 类 


BluetoothClass.Service 类 的 格式 如 下 所 示 。 
public static final class BluetoothClass.Service extends Object 
BluetoothClass.Service 类 的 结构 如 下 所 示 。 


java.lang.Object 
android.bluetooth.BluetoothClass.Service 


BluetoothClass.Service 类 用 于 定义 所 有 的 服务 类 常量 ， 任 意 BluetoothClass 由 0 或 多 个 服务 类 编码 


组 成 。 在 BluetoothClass.Service 类 中 包含 如 下 常量 。 
Q int AUDIO 
Q int CAPTURE 
Q int INFORMATION 
О int LIMITED DISCOVERABILITY 
О int NETWORKING 
Q int OBJECT TRANSFER 
Ü int POSITIONING 
Q int RENDER 
Q int TELEPHONY 
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6.4.5 BluetoothClass.Device 类 
BluetoothClass.Device 类 的 格式 如 下 所 示 。 

public final class BluetoothClass.Device extends Object 
BluetoothClass.Device 类 的 结构 如 下 所 示 。 


java.lang.Object 
android.bluetooth.BluetoothClass.Device 
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BluetoothClass.Device 类 用 于 定义 所 有 的 设备 类 的 常量 ， 每 个 BluetoothClass 有 一 个 带 有 主要 和 较 
小 部 分 的 设备 类 进行 编码 。 里 面 的 常量 代表 主要 和 较 小 的 设备 类 部 分 〈 完 整 的 设备 类 ) 的 组 合 。 
BluetoothClass.Device.Major 的 常量 只 能 代表 主要 设备 类 。 
BluetoothClass.Device 有 一 个 内 部 类 ， 此 内 部 类 定义 了 所 有 的 主要 设备 类 常量 。 内 部 类 的 定义 格式 
如 下 所 示 。 
class BluetoothClass.Device.Major 
注意 : 到 此 为 止 ，Android 中 的 蓝牙 类 介绍 完毕 。 我 们 在 调用 这 些 类 时 ， 除 了 首先 确保 APILevel 至 少 为 
版 本 5 以 上 ,并 且 还 需 注意 添加 相应 的 权限 ， 比 如 在 使 用 通信 时 ， 需 要 在 文件 androidmanifestxml 
中 加 入 <uses-permission android:name="android.permission. BLUETOOTH" /> 权限 ， 而 在 开关 蓝牙 
时 需要 类 似 android.permission BLUETOOTH ADMIN 权 限 。 


6.5 Android BlueDroid 架构 详解 


GH 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 6 H\Android BlueDroid 架构 详解 .avi 
THEY Android 系统 中 低 功 耗 蓝牙 协议 栈 BlueDroid 的 基本 知识 后 ， 在 本 节 的 内 容 中 ， 将 详细 讲解 
Android 源码 中 低 功 耗 协议 栈 BlueDroid 的 具体 架构 知识 ， 为 读者 学 习 本 书后 面 的 知识 打下 基础 。 


6.5.1 Android 系统 中 BlueDroid 的 架构 


在 Android 新 系统 中 ， 采 用 BlueDroid 作为 默认 的 协议 栈 ，BlueDroid 分 为 如 下 两 个 部 分 。 

口 Bluetooth Embedded System (BTE): 实现 了 BT 的 核心 功能 。 

口 Bluetooth Application Layer (BTA): 用 于 和 Android Framework 层 进行 交互 。 

在 Android 新 系统 中 ，BT 系统 服务 通过 JNI 与 BT stack 进行 交互 ， 并 且 通 过 Binder IPC 通信 与 应 
用 交互 , 这 个 系统 服务 同时 也 提供 给 RD 获取 不 同 的 BT profiles。 如 图 6-5 展示 了 BT stack 的 一 个 大 体 
的 结构 。 


Applicaton Framework 


narowareni oranan udeardware) 


Apps 
ы Bluetooth HAL Interfaces E EH 


(vendor н а company 


Bluetootn Process (packages/apps/ 
Bluetoom) Custom Configurations Bluetooth App Layer 
Bluetooth Embedded 
Custom Extensions System 


图 6-5 BT stack 的 结构 
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6.5.2 Application Framework 层 分 析 


在 Application Framework 层 中 ， 功 能 是 利用 android.bluetooth APIS 和 Bluetooth Hardware 层 进 行 
交互 ， 也 就 是 通过 Binder IPC 机 制 调用 Bluetooth 进程 。Application Framework 层 的 代码 位 于 如 下 所 示 
的 目录 中 。 

framework/base/core/java/android.bluetooth/ 

TE X- fF framework/base/core/java/android/bluetooth/BluetoothA 2dp.java F ¿É X. Y connect(Bluetoo- 
thDevice device) 方 法 ， 功 能 是 通过 Binder IPC 通信 机 制 调 用 如 下 文件 中 的 一 个 内 部 私有 类 。 

packages/apps/Bluetooth/src/com/android/bluetooth/a2dp/A2dpService.java 

文件 BluetoothA2dp.java 的 具体 实现 代码 如 下 所 示 。 

public final class BluetoothA2dp implements BluetoothProfile { 

private static final String TAG = "BluetoothA2dp"; 

private static final boolean DBG = true; 

private static final boolean VDBG = false; 

@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 

public static final String ACTION CONNECTION STATE CHANGED = 
"android.bluetooth.a2dp.profile.action. CONNECTION STATE CHANGED"; 

(QSdkConstant(SdkConstantType.BROADCAST INTENT ACTION) 

public static final String ACTION PLAYING STATE CHANGED - 
"android.bluetooth.a2dp.profile.action.PLAYING STATE CHANGED"; 

public static final int STATE PLAYING = 10; 

public static final int STATE NOT PLAYING = 11; 


private Context mContext; 

private ServiceListener mServiceListener; 
private IBluetoothA2dp mService; 

private BluetoothAdapter mAdapter; 


final private IBluetoothStateChangeCallback mBluetoothStateChangeCallback = 
new IBluetoothStateChangeCallback.Stub() { 
public void onBluetoothStateChange(boolean up) { 
if (DBG) Log.d(TAG, "onBluetoothStateChange: up=" + up); 
if (lup) { 
if (VDBG) Log.d(TAG,"Unbinding service..."); 
synchronized (mConnection) ( 
try { 
mService = null; 
mContext.unbindService(mConnection); 
) catch (Exception re) { 
Log.e(TAG,"",re); 
} 
} 
) else { 
synchronized (mConnection) { 
try { 
if (mService == null) { 
if (VDBG) Log.d(TAG, "Binding service..."); 
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if (ImContext.bindService(new Intent(IBluetoothA2dp.class.getName()), 
mConnection, 0)) { 
Log.e(TAG, "Could not bind to Bluetooth A2DP Service"); 
} 
} 
) catch (Exception re) { 
Log.e(TAG,"",re); 
} 


} 
y 
BluetoothA2dp(Context context, ServiceListener 1) ( 
mContext = context; 
mServiceListener = |; 
mAdapter = BluetoothAdapter.getDefaultAdapter(); 
IBluetoothManager mgr = mAdapter.getBluetoothManager(); 


if (mgr != null) { 
try { 
mgr.registerStateChangeCallback(mBluetoothStateChangeCallback); 
} catch (RemoteException e) { 
Log.e(TAG,"",e); 
} 
} 


if (Icontext.bindService(new Intent(IBluetoothA2dp.class.getName()), mConnection, 0)) { 
Log.e(TAG, "Could not bind to Bluetooth A2DP Service"); 
) 
) 


void close() { 
mServiceListener = null; 
IBluetoothManager mgr = mAdapter.getBluetoothManager(); 
if (mgr != null) ( 
try { 
mgr.unregisterStateChangeCallback(mBluetoothStateChangeCallback); 
} catch (Exception e) { 
Log.e(TAG,"",e); 
} 
} 


synchronized (mConnection) { 
if (mService != null) ( 

try { 
mService = null; 
mContext.unbindService(mConnection); 

} catch (Exception re) { 
Log.e(TAG," re); 

} 
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} 


public void finalize() { 
close(); 
} 
public boolean connect(BluetoothDevice device) { 
if (DBG) log("connect(" + device + ")"); 
if (mService != null && isEnabled() && 
isValidDevice(device)) { 


try { 
return mService.connect(device); 
} catch (RemoteException e) { 
Log.e(TAG, "Stack:" + Log.getStackTraceString(new Throwable())); 
return false; 
} 
} 
if (mService == null) Log.w(TAG, "Proxy not attached to service"); 
return false; 


} 
public boolean disconnect(BluetoothDevice device) { 
if (DBG) log("disconnect(" + device + ")"); 
if (mService != null && isEnabled() && 
isValidDevice(device)) { 
try { 
return mService.disconnect(device); 
} catch (RemoteException e) { 
Log.e(TAG, "Stack:" + Log.getStackTraceString(new Throwable())); 


return false; 
} 
} 
if (mService == null) Log.w(TAG, "Proxy not attached to service"); 
return false; 
} 
p 
* {@inheritDoc} 
vii 


public List<BluetoothDevice> getConnectedDevices() { 
if (VDBG) log("getConnectedDevices()"); 
if (mService != null && isEnabled()) ( 
ty( 
return mService.getConnectedDevices(); 
) catch (RemoteException e) ( 
Log.e(TAG, "Stack:" + Log.getStackTraceString(new Throwable())); 
return new ArrayList<BluetoothDevice>(); 
} 
} 
if (mService == null) Log.w(TAG, "Proxy not attached to service"); 
return new ArrayList<BluetoothDevice>(); 
} 
public List<BluetoothDevice> getDevicesMatchingConnectionStates(int[ ] states) { 


@ 
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if (VDBG) log("getDevicesMatchingStates()"); 
if (mService != null && isEnabled()) { 
try{ 
return mService.getDevicesMatchingConnectionStates(states); 
} catch (RemoteException e) { 
Log.e(TAG, "Stack:" + Log.getStackTraceString(new Throwable())); 
return new ArrayList<BluetoothDevice>(); 
} 
} 
if (mService == null) Log.w(TAG, "Proxy not attached to service"); 
return new ArrayList<BluetoothDevice>(); 
} 
public int getConnectionState(BluetoothDevice device) { 
if (VDBG) log("getState(" + device + ")"); 
if (mService != null && isEnabled() 
&& isValidDevice(device)) { 
try { 
return mService.getConnectionState(device); 
} catch (RemoteException e) { 
Log.e(TAG, "Stack:" + Log.getStackTraceString(new Throwable())); 
return BluetoothProfile.STATE_DISCONNECTED; 
} 
} 
if (mService == null) Log.w(TAG, "Proxy not attached to service"); 
return BluetoothProfile.STATE DISCONNECTED; 
} 
public boolean setPriority(BluetoothDevice device, int priority) { 
if (ОВС) log("setPriority(" + device + ", " + priority + ")"); 
if (mService != null && isEnabled() 
&& isValidDevice(device)) { 
if (priority != BluetoothProfile.PRIORITY OFF && 
priority != BluetoothProfile.PRIORITY ON)( 
return false; 
} 
try { 
return mService.setPriority(device, priority); 
} catch (RemoteException e) { 
Log.e(TAG, "Stack:" + Log.getStackTraceString(new Throwable())); 
return false; 
} 


} 
if (mService == null) Log.w(TAG, "Proxy not attached to service"); 


return false; 
} 
public int getPriority(BluetoothDevice device) { 
if (VDBG) log("getPriority(" + device + ")"); 
if (mService != null && isEnabled() 
&& isValidDevice(device)) { 
try { 
return mService.getPriority(device); 
} catch (RemoteException e) { 
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Log.e(TAG, "Stack:" + Log.getStackTraceString(new Throwable())); 
return BluetoothProfile.PRIORITY OFF; 
} 
} 
if (mService == null) Log.w(TAG, "Proxy not attached to service"); 
return BluetoothProfile.PRIORITY OFF; 
} 
public boolean isA2dpPlaying(BluetoothDevice device) { 
if (mService != null && isEnabled() 
&& isValidDevice(device)) { 


try { 
return mService.isA2dpPlaying(device); 
} catch (RemoteException e) { 
Log.e(TAG, "Stack:" + Log.getStackTraceString(new Throwable())); 
return false; 
} 
} 
if (mService == null) Log.w(TAG, "Proxy not attached to service"); 
return false; 


} 


public boolean shouldSendVolumeKeys(BluetoothDevice device) { 
if (isEnabled() && isValidDevice(device)) { 
ParcelUuid[ ] uuids = device.getUuids(); 
if (uuids == null) return false; 


for (ParcelUuid uuid: uuids) { 
if (BluetoothUuid.isAvrcpTarget(uuid)) { 
return true; 
} 
} 
} 
return false; 
} 
public static String stateToString(int state) { 
switch (state) { 
case STATE DISCONNECTED: 
return "disconnected"; 
case STATE CONNECTING: 
return "connecting"; 
case STATE CONNECTED: 
return "connected"; 
case STATE DISCONNECTING: 
return "disconnecting"; 
case STATE PLAYING: 
return "playing"; 
case STATE NOT PLAYING: 
return "not playing"; 
default: 
return "«unknown state " + state + ">"; 
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private ServiceConnection mConnection = new ServiceConnection() { 
public void onServiceConnected(ComponentName className, Binder service) { 
if (DBG) Log.d(TAG, "Proxy object connected"); 
mService = |BluetoothA2dp.Stub.asinterface(service); 


if (mServiceListener != null) { 
mServiceListener.onServiceConnected(BluetoothProfile.A2DP, BluetoothA2dp.this); 
} 
} 


public void onServiceDisconnected(ComponentName className) { 
if (DBG) Log.d(TAG, "Proxy object disconnected"); 
mService = null; 
if (mServiceListener !- null) ( 
mServiceListener.onServiceDisconnected(BluetoothProfile.A2DP); 
} 
} 
Е 
在 上 述 代码 


H 


要 实现 代码 如 下 所 示 。 
public class A2dpService extends ProfileService { 
private static final boolean DBG = false; 
private static final String TAG="A2dpService"; 


private A2dpStateMachine mStateMachine; 
private Avrcp mAvrcp; 
private static A2dpService sAd2dpService; 


protected String getName() ( 
return TAG; 
} 


protected IProfileServiceBinder initBinder() { 
return new BluetoothA2dpBinder(this); 


} 

protected boolean start() { 
mStateMachine = A2dpStateMachine.make(this, this); 
mAvrep = Avrcp.make(this); 
setA2dpService(this); 
return true; 

} 

protected boolean stop() { 
mStateMachine.doQuit(); 
mAvrcp.doQuit(); 
return true; 

} 


‚ ЖХ Y A2dpService 对 象 service， 并 调用 getService() 方 法 。A2dpService 是 一 个 继 
承 于 类 ProfileService 的 子 类 ,而 ProfileService 是 继承 于 类 Service 的 子 类 。 文件 A2dpService.java HJE 
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protected boolean cleanup() ( 

if (mStateMachine!= null) { 
mStateMachine.cleanup(); 

} 

if (mAvrcp != null) { 
mAvrcp.cleanup(); 
mAvrep = null; 

} 

clearA2dpService(); 

return true; 


} 


ПАРІ Methods 


public static synchronized A2dpService getA2dpService()( 
if (sAd2dpService != null && sAd2dpService.isAvailable()) { 
if (DBG) Log.d(TAG, "getA2DPService(): returning " + sAd2dpService); 
return sAd2dpService; 
} 
if(DBG) ( 
if (SAd2dpService == null) ( 
Log.d(TAG, "getA2dpService(): service is NULL"); 
} else if (!(sAd2dpService.isAvailable())) ( 
Log.d(TAG,"getA2dpService(): service is not available"); 
} 
} 
return null; 


} 


private static synchronized void setA2dpService(A2dpService instance) { 
if (instance != null && instance.isAvailable()) { 
if (ОВС) Log.d(TAG, "setA2dpService(): set to: " + sAd2dpService); 
sAd2dpService = instance; 


}else { 
if (DBG) ( 
if (sAd2dpService == null) { 
Log.d(TAG, "setA2dpService(): service not available"); 
} else if (IsAd2dpService.isAvailable()) ( 
Log.d(TAG,"setA2dpService(): service is cleaning up"); 
) 
) 
) 


) 


private static synchronized void clearA2dpService() ( 
sAd2dpService = null; 
} 


public boolean connect(BluetoothDevice device) { 
enforceCallingOrSelfPermission(BLUETOOTH ADMIN PERM, 
"Need BLUETOOTH ADMIN permission"); 
@ 


} 
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if (getPriority(device) == BluetoothProfile.PRIORITY OFF)( 
return false; 


} 


int connectionState = mStateMachine.getConnectionState(device); 

if (connectionState == BluetoothProfile.STATE_CONNECTED || 
connectionState == BluetoothProfile.STATE CONNECTING) { 
return false; 


} 


mStateMachine.sendMessage(A2dpStateMachine.CONNECT, device); 
return true; 


boolean disconnect(BluetoothDevice device) { 


} 


enforceCallingOrSelfPermission(BLUETOOTH_ADMIN_PERM, 
"Need BLUETOOTH ADMIN permission"); 
int connectionState = mStateMachine.getConnectionState(device); 
if (connectionState != BluetoothProfile STATE CONNECTED && 
connectionState != BluetoothProfile.STATE CONNECTING) { 
return false; 


} 


mStateMachine.sendMessage(A2dpStateMachine.DISCONNECT, device); 
return true; 


由 此 可 见 , 在 接 下 来 的 通信 过 程 中 , 通过 Binder IPC 通信 机 制 调 用 了 文件 A2dpService;java 中 的 connect 
(BluetoothDevice device) 方 法 。 上 述 过 程 就 是 Bluetooth Application Framework 与 Bluetooth Process 之 间 
的 调用 过 程 。 


6.5.3 分 析 Bluetooth System Service E 


在 Android 系统 中 ，Bluetooth System Service 位 于 packages/apps/Bluetooth 目录 下 ， 将 其 打包 成 一 


个 Android App (And 


roid 应 用 程序 ) 包 ， 并 且 在 Android Framework 层 实现 BT Service 和 各 种 profile. 
BT App 接 下 来 会 通过 INI 调用 到 HAL 层 。 


在 文件 A2dpServicejava 中 , connect 方法 会 发 送 一 个 StateMachine.sendMessage(A2dpStateMachine. 
CONNECT, device) 的 message( 信 息 0, 这 个 message 会 被 A2dpStateMachine 对 象 的 processMessage(Message) 


方法 接收 到 ) ， 对 应 代码 如 下 所 示 。 
сазе СОММЕСТ: 


BluetoothDevice device = (BluetoothDevice) message.obj; 
broadcastConnectionState(device, BluetoothProfile.STATE CONNECTING, 
BluetoothProfile.STATE DISCONNECTED); 


if (!connectA2dpNative(getByteAddress(device)) ) ( 
broadcastConnectionState(device, BluetoothProfile.STATE DISCONNECTED, 
BluetoothProfile.SSTATE CONNECTING); 


® 


synchronized (A2dpStateMachine.this) { 
mTargetDevice = device; 
transitionTo(mPending); 
} 
II TODO(BT) remove CONNECT TIMEOUT when the stack 
II sends back events consistently 
sendMessageDelayed(CONNECT_TIMEOUT, 30000); 
break; 
在 上 述 代码 中 ,会 通过 “connectA2dpNative(getByteAddress(device)); ”代码 行 设置 通过 INI 调用 到 
Native 〈 本 地 程序 ): 
private native boolean connectA2dpNative(byte[ ] address); 


6.54 JNI 层 详解 


在 Android 系统 中 ， 和 Bluetooth 有 关 的 INI 代码 位 于 如 下 所 示 的 目录 中 。 

packages/apps/bluetooth/jni 

INI 层 的 代码 会 调用 到 HAL 层 ， 并 且 在 确信 一 些 BT 操作 被 触发 时 从 HAL 获取 一 些 回调 ， 例 如 
当 BT 设备 被 发 现时 。 例 如 在 A2dp 连接 的 例子 中 ,BT System Service 会 通过 JNI 调用 文件 com_android_ 
bluetooth a2dp.cpp 中 的 方法 ， 此 文件 的 主要 实现 代码 如 下 所 示 。 

namespace android { 


static jmethodID method onConnectionStateChanged; 
static jmethodID method_onAudioStateChanged; 


static const btav interface t *sBluetoothA2dpInterface = NULL; 
static jobject mCallbacksObj = NULL; 
static JNIEnv *sCallbackEnv = NULL; 


static bool checkCallbackThread() ( 
/ Always fetch the latest callbackEnv from AdapterService. 
II Caching this could cause this sCallbackEnv to go out-of-sync 
II with the AdapterService's ENV if an ASSOCIATE/DISASSOCIATE event 
II is received 
llif (sCallbackEnv == NULL) ( 
sCallbackEnv = getCallbackEnv(); 
Il) 


JNIEnv* env = AndroidRuntime::getJNIEnv(); 
if (sCallbackEnv != env || sCallbackEnv == NULL) return false; 


return true; 


} 


static void bta2dp_connection_state_callback(btav_connection_state_t state, bt bdaddr t* bd addr) { 
jbyteArray addr; 


ALOGI("%s", FUNCTION j; 


@ 
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if (IcheckCallbackThread()){ \ 
ALOGE("Callback: '%s' is not called on the correct thread", FUNCTION_); \ 
return; \ 


} 

addr = sCallbackEnv->NewByteArray(sizeof(bt_bdaddr_t)); 

if (laddr) { 
ALOGE("Fail to new jbyteArray bd addr for connection state"); 
checkAndClearExceptionFromCallback(sCallbackEnv, _ FUNCTION ); 
return; 


} 


sCallbackEnv->SetByteArrayRegion(addr, 0, sizeof(bt_bdaddr_t), (jbyte*) bd_addr); 
sCallbackEnv->CallVoidMethod(mCallbacksObj, method_onConnectionStateChanged, (jint) state, 
addr); 
checkAndClearExceptionFromCallback(sCallbackEnv, |. FUNCTION  ); 
sCallbackEnv->DeleteLocalRef(addr); 
} 


static void bta2dp_audio_state_callback(btav_audio_state_t state, bt_bdaddr_t* bd_addr) { 
jbyteArray addr; 


ALOGI("%s", FUNCTION. ); 


if (IcheckCallbackThread()) ( \ 
ALOGE("Callback: '%s' is not called on the correct thread", FUNCTION_); \ 
return; \ 

} 

addr = sCallbackEnv->NewByteArray(sizeof(bt_bdaddr_t)); 

if (laddr) { 


ALOGE("Fail to new jbyteArray bd addr for connection state"); 
checkAndClearExceptionFromCallback(sCallbackEnv, _ FUNCTION  ); 
return; 


} 


sCallbackEnv->SetByteArrayRegion(addr, 0, sizeof(bt bdaddr t), (jbyte*) bd addr); 
sCallbackEnv->CallVoidMethod(mCallbacksObj, method onAudioStateChanged, (jint) state, 
addr); 
checkAndClearExceptionFromCallback(sCallbackEnv, |. FUNCTION  ); 
sCallbackEnv->DeleteLocalRef(addr); 
} 


static btav_callbacks_t sBluetoothA2dpCallbacks = { 
sizeof(sBluetoothA2dpCallbacks), 
bta2dp_connection_state_callback, 
bta2dp_audio_state_callback 

h 


static void classlnitNative(JNIEnv* env, jclass clazz) { 


int err; 
const bt_interface_t* btInf; 
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bt_status_t status; 


method_onConnectionStateChanged = 
env-»GetMethodlD(clazz, "onConnectionStateChanged", "(I[B)V"); 


method onAudioStateChanged = 
env-»GetMethodlD(clazz, "onAudioStateChanged", "(I[B) V"); 
F 
if ( (btInf = getBluetoothInterface()) == NULL) { 
ALOGE("Bluetooth module is not loaded"); 
return; 


} 


if ( (sBluetoothA2dplnterface = (btav_interface_t *) 
btInf->get_profile_interface(BT_PROFILE_ADVANCED_AUDIO_ID)) == NULL) { 
ALOGE("Failed to get Bluetooth A2DP Interface"); 
return; 


dl 


II TODO(BT) do this only once or 

I Do we need to do this every time the BT reenables? 

r 

if ( (status = sBluetoothA2dpInterface->init(&sBluetoothA2dpCallbacks)) != BT STATUS SUCCESS) { 
ALOGE("Failed to initialize Bluetooth A2DP, status: %d", status); 
sBluetoothA2dplnterface = NULL; 
return; 

yl 


ALOGI("%s: succeeds", FUNCTION _ ); 
} 


static void initNative(JNIEnv *env, jobject object) { 
const bt_interface_t* Ып; 
bt_status_t status; 


if ( (btInf = getBluetoothInterface()) == NULL) { 
ALOGE("Bluetooth module is not loaded"); 
return; 


} 


if (sBluetoothA2dplnterface !=NULL) { 
ALOGW("Cleaning up A2DP Interface before initializing..."); 
sBluetoothA2dpinterface->cleanup(); 
sBluetoothA2dpInterface = NULL; 

} 


if (mCallbacksObj != NULL) { 
ALOGW("Cleaning up A2DP callback object"); 
env->DeleteGlobalRef(mCallbacksObj); 
mCallbacksObj = NULL; 


@ 
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} 


if ( (sBluetoothA2dpInterface = (btav interface t *) 
btInf->get_profile_interface(BT_PROFILE_ADVANCED_AUDIO_ID)) == NULL) { 
ALOGE("Failed to get Bluetooth A2DP Interface"); 
return; 


} 


if ( (status = sBluetoothA2dpInterface->init(&sBluetoothA2dpCallbacks)) != BT STATUS SUCCESS) { 
ALOGE("Failed to initialize Bluetooth A2DP, status: %d", status); 
sBluetoothA2dpinterface = NULL; 
return; 


} 


mCallbacksObj = env->NewGlobalRef(object); 
} 


static void cleanupNative(JNIEnv *env, jobject object) { 
const bt interface t* btInf; 
bt status t status; 


if ( (btInf = getBluetoothInterface()) == NULL) ( 
ALOGE("Bluetooth module is not loaded"); 
return; 


) 


if (sBluetoothA2dplnterface !- NULL) { 
sBluetoothA2dplnterface-»cleanup(); 
sBluetoothA2dplnterface = NULL; 

) 


if (mCallbacksObj != NULL) ( 
env->DeleteGlobalRef(mCallbacksObj); 
mCallbacksObj = NULL; 


} 


static jboolean connectA2dpNative(JNIEnv *env, jobject object, jbyteArray address) { 
jbyte *addr; 
bt_bdaddr_t * btAddr; 
bt_status_t status; 


ALOGI("%s: sBluetoothA2dpinterface: %p", FUNCTION  , sBluetoothA2dpInterface); 
if (IsBluetoothA2dplInterface) return JNI FALSE; 


addr = env->GetByteArrayElements(address, NULL); 
btAddr = (bt bdaddr t*) addr; 
if (laddr) { 

jniThrowlOException(env, EINVAL); 

return JNI FALSE; 
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if ((status = sBluetoothA2dpInterface->connect((bt_bdaddr_t *)addr)) != BT STATUS SUCCESS){ 
ALOGE("Failed HF connection, status: %d", status); 

} 

env->ReleaseByteArrayElements(address, addr, 0); 

return (status == BT STATUS SUCCESS) ? JNI TRUE : JNI FALSE; 


} 


static boolean disconnectA2dpNative(JNIEnv *env, jobject object, jbyteArray address) { 
jbyte *addr; 
bt status t status; 


if ('sBluetoothA2dpInterface) return JNI FALSE; 


addr = env->GetByteArrayElements(address, NULL); 
if (laddr) { 

jniThrowlOException(env, EINVAL); 

return JNI_FALSE; 
} 


if ( (status = sBluetoothA2dpInterface->disconnect((bt_bdaddr_t *)addr)) != BT STATUS SUCCESS) { 
ALOGE("Failed HF disconnection, status: %d", status); 
} 
env->ReleaseByteArrayElements(address, addr, 0); 
return (status == BT STATUS SUCCESS) ? JNI TRUE : JNI FALSE; 
) 


static JNINativeMethod sMethods[] = ( 
("classinitNative", "()V", (void *) classlnitNative), 
{"initNative", "()V", (void *) initNative}, 
("cleanupNative", "()V", (void *) cleanupNative}, 
("connectA2dpNative", "([B)Z", (void *) connectA2dpNative}, 
{"disconnectA2dpNative", "([B)Z", (void *) disconnectA2dpNative}, 


} 
int register com android bluetooth a2dp(JNIEnv* env) 
( 
return jniRegisterNativeMethods(env, "com/android/bluetooth/a2dp/A2dpStateMachine", 
sMethods, NELEM(sMethods)); 
} 
} 


在 上 述 代 码 中 用 到 了 结构 体 对 象 sBluetoothA2dpInterface， 此 对 象 在 方法 initNative(JNIEnv *env, 
jobject object) 中 定义 获取 ， 即 如 下 所 示 的 代码 。 
if ( (sBluetoothA2dpInterface = (btav interface t*) 
btinf->get_profile_interface(BT_PROFILE_ADVANCED AUDIO ID)) == NULL) { 
ALOGE("Failed to get Bluetooth A2DP Interface"); 
return; 


6. 
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6.5.5 HAL 层 详解 


硬件 抽象 层 用 于 定义 android.bluetooth APIs 和 BT process 调用 的 标准 接口 , BT HAL 的 头 文件 位 于 
如 下 所 示 的 文件 中 。 

hardware/libhardware/include/hardware/bluetooth.h 

hardware/libhardware/include/hardware/bt_*.h 


JNI 中 sBluetoothA2dpInterface 是 一 个 btav interface t 结构 体 ， 位 于 hardware/libhardware/include/ 
hardware/bt_av.h 中 ， 具 体 定义 代码 如 下 所 示 。 
typedef struct { 
size t size; 
bt_status_t (*init)( btav_callbacks_t* callbacks ); 
bt status t (*connect)( bt bdaddr t *bd адаг); 
bt status t (*disconnect)( bt bdaddr t*bd addr ); 
void (*cleanup)( void ); 
) btav interface t; 
Android 系统 新 版 本 默认 蓝牙 协议 栈 BlueDroid 在 如 下 所 示 的 目录 下 实现 。 
external/bluetooth/bluedroid 


ТЖ stack 实现 了 通用 的 BT HAL 并 且 也 可 以 通过 扩展 和 改变 配置 来 自 定义 。 例 如 A2dp 的 连接 会 


调用 到 external/bluetooth/bluedroid/btif/src/btif av.c 的 connect() 方 法 ， 此 方法 的 具体 实现 代码 如 下 所 示 。 
static bt status t connect(bt bdaddr t*bd addr) 


BTIF_TRACE_EVENT1("%s", FUNCTION ); 
CHECK BTAV INIT(); 


return btif queue connect(UUID SERVCLASS AUDIO SOURCE, bd addr, connect int); 


第 7 章 NFC 近 场 通信 


МЕС 是 近 场 通信 (Near Field Communication) 的 缩写 ， 随 着 移动 智能 设备 的 发 展 和 普及 ， 在 很 多 
智能 手机 中 都 提供 了 NFC 近 场 通信 功能 。 作 为 一 款 著 名 的 操作 系统 ，Android 系统 提供 了 对 NFC 技术 
的 完整 支持 。 本 章 将 详细 讲解 在 Android 外 设 项 目 开发 使 用 近 场 通信 技术 的 基本 知识 ， 为 学 习 本 书后 
面 的 知识 打下 基础 。 


7.1 近 场 通信 技术 基础 


Фи 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 7 章 \ 近 场 通信 技术 基础 .avi 

NEC 近 场 通信 技术 是 由 非 接触 式 射 频 识别 (RFID) 及 互联 互通 技术 整合 演变 而 来 ,在 单一 芯片 上 结 
合 感应 式 读 卡 器 、 感 应 式 卡片 和 点 对 点 的 功能 ， 能 在 短 距离 内 与 兼容 设备 进行 识别 和 数据 交换 。 工 作 频 
RH 13.56MHz, 但 是 使 用 这 种 手机 支付 方案 的 用 户 必须 更 换 特制 的 手机 。 目前 这 项 技术 在 日 韩 被 广泛 应 
用 。 手 机 用 户 赁 着 配置 了 支付 功能 的 手机 就 可 以 行 遍 全 国 ， 他 们 的 手机 可 以 用 作 机 场 登 机 验证 、 大 厦 的 
门禁 钥匙 、 交 通 一 卡通 、 信 用 卡 、 支 付 卡 等 。 本 节 将 简要 讲解 NFC 技术 的 基本 知识 。 


7.4.4 NFC 技术 的 特点 


近 场 通信 是 基于 RFID 技术 发 展 起 来 的 一 种 近 距 离 无 线 通信 技术 。 与 RFID 一 样 ， 近 场 通信 信息 也 
是 通过 频谱 中 无 线 频率 部 分 的 电磁 感应 耦合 方式 传递 的 ， 但 两 者 之 间 还 是 存在 很 大 的 区 别 。 近 场 通信 
的 传输 范围 比 RFID 小 ，RFID 的 传输 范围 可 以 达到 0 一 lm， 但 由 于 近 场 通信 采取 了 独特 的 信号 衰减 技 
Ж, ЖТР RFID 来 说 近 场 通信 具有 成 本 低 、 带 宽 高 、 能 耗 低 等 特点 。 

在 现实 应 用 中 ， 近 场 通信 技术 主要 特征 如 下 。 

О 用 于 近 距 离 (10cm 以 内 ) 安全 通信 的 无 线 通 信 技 术 。 

О 射频 频率 ，13.56MHz。 

Q 射频 兼容 ，ISO 14443, ISO 15693，Felica 标 准 。 

о 数据 传输 速度 : 106Kbit/s, 212 Kbit/s, 424Kbit/s. 


7.12 NFC 的 工作 模式 


在 现实 应 用 中 ，NFC 技术 有 如 下 3 种 工作 模式 。 

O FPE (Card emulation): 此 模式 其 实 就 是 相当 于 一 张 采用 RFID 技 术 的 IC 卡 。 可 以 替代 现在 
大 量 的 IC 卡 (包括 信用 卡 ) 场合 商场 刷卡 、 公 交 卡 、 门 禁 管制 、 车 票 、 门 票 等 。 此 种 方式 ， 有 
一 个 极 大 的 优点 ， 那 就 是 卡片 通过 非 接触 读 卡 器 的 RF 域 来 供电 ， 即 便 是 寄主 设备 (如 和 手机) 
没 电 也 可 以 工作 。 
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O 点 对 点 模式 (P2P mode) : 此 模式 和 红外 线 差不多 ， 可 用 于 数据 交换 ， 只 是 传输 距离 较 短 ， 传 
输 创建 速度 较 快 ， 传 输 速 度 也 快 ， 功 耗 低 蓝牙 也 类 似 ) 。 将 两 个 具备 NFC 功 能 的 设备 链接 ， 
实现 数据 点 对 点 传输 ， 如 下 载 音乐 、 交 换 图 片 或 者 同步 设备 地 址 簿 。 因 此 通过 NFC， 多 个 设 
备 如 数位 相机 、PDA、 计 算 机 和 手机 之 间 都 可 以 交换 资料 或 者 服务 。 

O 读 卡 器 模式 (Reader/writer mode) : 作为 非 接触 读 卡 器 使 用 ， 比 如 从 海报 或 者 展览 信息 电子 标 
签 上 读 取 相关 信息 。 


7.1.3 NFC 和 蓝牙 的 对 比 


NFC 的 最 大 数据 传输 量 是 424 Kbits， 这 远 小 于 Bluetooth V2.1 (2.1 Mbit/s). £A NFC 在 传输 速 
度 与 距离 方面 比 不 上 BlueTooth， 但 是 NFC 技术 不 需要 电源 ， 对 于 移动 电话 或 是 移动 消费 性 电子 产品 
来 说 ，NFC 的 使 用 比较 方便 。NFC 的 短 距离 通信 特性 正 是 其 优点 ， 由 于 耗 电 量 低 、 一 次 只 和 一 台 机 器 
连接 ， 拥 有 较 高 的 保密 性 与 安全 性 ，NFC 有 利于 信用 卡 交易 时 避免 被 盗用 。NFC 的 目标 并 非 取 代 蓝 牙 
等 其 他 无 线 技术 ， 而 是 在 不 同 的 场合 、 不 同 的 领域 起 到 相互 补充 的 作用 。 

МЕС 技术 和 蓝牙 技术 相 比 ， 主 要 支持 功能 参数 如 表 7-1 所 示 。 


表 7-1 МЕС 技术 和 蓝牙 技术 的 参数 对 比 


ў. а МЕС Bluetooth Bluetooth Low Energ 
RFID 兼容 ISO 18000-3 active active 
标准 化 机 构 ISO/IEC Bluetooth SIG Bluetooth SIG 
网 络 标准 ISO 13157 etc. IEEE 802.15.1 IEEE 802.15.1 
网 络 类 型 Point-to-point WPAN WPAN 
mE not with RFID available available 
范围 «02m ~10m (class 2 ~lm (class 3 
频率 13.56 MHz 2.4~2.5 GHz 2.4~2.5 GHz 
Bitrate 424 Kbit/s 2.1 Mbit/s ~1.0 Mbit/s 
设置 程序 <0.15 < 65 <18 
功 耗 < ]5mA (read) varies with class < 15mA (xmit 
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射频 识别 即 RFID (Radio Frequency Identification) 技术， 又 称 无 线 射频 识别 ， 是 NFC 技术 的 
一 个 子 集 。RFID 是 一 种 通信 技术 ， 可 以 通过 无 线 电 信号 识别 特定 目标 并 读 写 相关 数据 ， 而 无 须 识 
别 系 统 与 特定 目标 之 间 建 立 机 械 或 光学 接触 。 在 现实 中 常用 的 RFID 技术 有 低频 (125 一 134.2kHz)、 
高 频 (13.56MHz)、 超 高 频 ， 微 波 等 技术 。RFID 读 写 器 也 分 移动 式 的 和 固定 式 的 ， 目 前 RFID dx 
术 应 用 很 广 ， 如 图 书馆 、 门 禁 系 统 和 食品 安全 溯源 等 。 本 节 将 详细 讲解 射频 识别 技术 RFID 的 基 
本 知识 。 
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7.21 RFID 技术 简介 


从 概念 上 来 讲 , RFID 类 似 于 条 码 扫描 , 对 于 条 码 技术 而 言 , 它 是 将 已 编码 的 条 形 码 附 着 于 目标 物 ， 
并 使 用 专用 的 扫描 读 写 器 利用 光 信 号 将 信息 由 条 形 磁 传 送 到 扫描 读 写 器 ; RFID 则 使 用 专用 的 RFID 
读 写 器 及 专门 的 可 附着 于 目标 物 的 RFID 标签 ,利用 频率 信号 将 信息 由 RFID 标签 传送 至 RFID 读 写 器 。 

无 线 电 的 信号 是 通过 调 成 无 线 电 频 率 的 电磁 场 ， 把 附着 在 物品 上 的 标签 数据 传送 出 去 ， 以 自动 辨 
识 与 追踪 该 物品 。 某 些 标签 在 识别 时 从 识别 器 发 出 的 电磁 场 中 就 可 以 得 到 能 量 ， 并 不 需要 电池 ; 也 有 
标签 本 身 拥有 电源 ， 并 可 以 主动 发 出 无 线 电波 〈 调 成 无 线 电 频 率 的 电磁 场 )。 标 签 包 含 了 电子 存储 的 信 
息 ， 数 米 之 内 都 可 以 识别 。 与 条 形 码 不 同 的 是 ， 射 频 标 签 不 需要 处 在 识别 器 视线 之 内 ， 也 可 以 嵌入 被 
追踪 物体 之 内 。 

在 现实 应 用 中 ， 有 许多 行业 都 运用 了 射频 识别 技术 。 将 标签 附着 在 一 辆 正在 生产 中 的 汽车 ， 厂 
家 便 可 以 追踪 此 车 在 生产 线 上 的 进度 。 射 频 标签 也 可 以 附 于 牲畜 与 宠物 上 ， 方 便 人 们 对 牲畜 与 宠物 
的 积极 识别 〈 积 极 识 别 意思 是 防止 数 只 牲畜 使 用 同一 个 身份 )。 射 频 识 别 的 身份 识别 卡 可 以 使 员工 得 
以 进入 锁 住 的 建筑 部 分 ， 汽 车 上 的 射频 应 答 器 也 可 以 用 来 征收 收费 路 段 与 停车 场 的 费用 。 

某 些 射频 标签 附 在 衣物 、 个 人 财物 上 ， 甚 至 植 入 人 体 之 内 。 由 于 这 项 技术 可 能 会 在 未 经 本 人 许可 
的 情况 下 读 取 个 人 信息 ， 所 以 这 项 技术 也 会 有 侵犯 个 人 隐私 的 忧患。 


7.22 RFID 技术 的 组 成 


从 结构 上 讲 RFID 是 一 种 简单 的 无 线 系统 ， 只 有 两 个 基本 器 件 ， 该 系统 用 于 控制 、 检 测 和 跟踪 物 
体 。 系 统 由 一 个 询问 器 和 很 多 应 答 器 组 成 。 在 最 初 的 技术 领域 中 ， 应 答 器 是 指 能 够 传输 信息 、 回 复 信 
息 的 电子 模块 。 近 年 来 ， 由 于 射频 技术 发 展 迅猛 ， 应 答 器 有 了 新 的 概念 和 含义 ， 又 被 叫做 智能 标签 或 
标签 。RFID 电子 标签 的 阅读 器 通过 天 线 与 RFID 电子 标签 进行 无 线 通 信 ， 可 以 实现 对 标签 识别 码 和 内 
存 数据 的 读 出 或 写 入 操作 。RFID 技术 可 识别 高 速 运动 物体 并 可 同时 识别 多 个 标签 ， 操 作 快 捷 方便 。 

伴随 着 RFID 技术 的 不 断 发 展 ， 其 具体 组 成 如 下 。 

о 应 答 器 : 由 天 线 、 耦 合 元 件 及 芯片 组 成 ， 一 般 来 说 都 是 用 标签 作为 应 答 器 ， 每 个 标签 具有 唯一 

的 电子 编码 ， 附 着 在 物体 上 标识 目标 对 象 。 

о 阅读 器 : 由 天 线 、 耦 合 元 件 及 芯片 组 成 ， 读 取 (有 时 还 可 以 写 入 ) 标签 信息 的 设备 ， 可 设计 为 
手持 式 RFID 读 写 器 (如 C5000W) 或 固定 式 读 写 器 。 

口 应 用 软件 系统 ， 是 应 用 层 软件 ， 主 要 是 把 收集 的 数据 进一步 处 理 ， 并 为 人 们 所 使 用 。 


7.2.3 RFID 技术 的 特点 


射频 识别 系统 最 重要 的 优点 是 非 接触 识别 ， 它 能 穿 透 雪 、 筋 、 冰 、 涂 料 、 侍 垢 和 条 形 码 无 法 使 用 
的 恶劣 环境 阅读 标签 ， 并 且 阅 读 速度 极 快 ， 大 多 数 情况 下 不 到 100ms。 有 源 式 射频 识别 系统 的 速写 能 
力也 是 重要 的 优点 ， 可 用 于 流程 跟踪 和 维修 跟踪 等 交互 式 业务 。 

制约 射频 识别 系统 发 展 的 主要 问题 是 不 兼容 的 标准 。 射 频 识 别 系 统 的 主要 厂商 提供 的 都 是 专用 系 
统 ， 导 致 不 同 的 应 用 和 不 同 的 行业 采用 不 同 广 商 的 频率 和 协议 标准 ， 这 种 混乱 和 制 据 的 状况 已 经 制约 
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了 整个 射频 识别 行业 的 增长 。 许 多 欧美 组 织 正在 着 手 解决 这 个 问题 ， 并 已 经 取得 了 一 些 成 绩 。 标 准 化 
必 将 刺激 射频 识别 技术 的 大 幅度 发 展 和 广泛 应 用 。 

RFID 技术 的 主要 特点 如 下 。 

о 快速 扫描 : RFID 辨 识 器 可 以 同时 辨识 读 取 数 个 RFID 标 签 。 

O 体积 小 型 化 、 形 状 多 样 化 ，RFID 在 读 取 上 并 不 受 尺寸 大 小 与 形状 限制 ， 不 需 为 了 读 取 精 确 度 

而 配合 纸张 的 固定 尺寸 和 印刷 品质 。 此 外 ，RFID 标 签 更 可 往 小 型 化 与 多 样 形态 发 展 ， 以 应 用 

于 不 同 产 品 。 

O 抗 污染 能 力 和 耐久 性 : 传统 条 形 码 的 载体 是 纸张 ， 因 此 容易 受到 污染 ,但 RFID 对 水 、 油 和 化 

学 药品 等 物质 具有 很 强 抵抗 性 。 此外， 由 于 条 形 码 是 附 于 塑料 袋 或 外 包装 纸箱 上 ， 所 以 特别 容 

易 受到 折 损 ，RFID 卷 标 是 将 数据 存在 芯片 中 ， 因 此 可 以 免 受 污 损 。 

о 可 重复 使 用 当今 的 条 形 码 印 刷 上 去 之 后 就 无 法 更 改 ，RFID 标 签 则 可 以 重复 地 新 增 、 修 改 、 
删除 RFID 卷 标 内 存储 的 数据 ， 方 便 信 息 的 更 新 。 

О 穿 透 性 和 无 屏障 阅读 : 在 被 覆盖 的 情况 下 ，RFID 能 够 穿 透 纸张 、 木 材 和 塑料 等 非 金属 或 非 透 
明 的 材质 , 并 能 够 进行 穿 透 性 通信 。 而 条 形 码 扫描 机 必须 在 近 距 离 而 且 没有 物体 阻挡 的 情况 下 ， 
才 可 以 辨 读 条 形 码 。 

Q 数据 的 记忆 容量 大 : 一 维 条 形 码 的 容量 是 0B， 二 维 条 形 码 最 大 的 容量 可 存储 2 一 3000 字 符 ， 
RFID 最 大 的 容量 则 有 数 兆 字 节 。 随 着 记忆 载体 的 发 展 ， 数 据 容量 也 有 不 断 扩 大 的 趋势 。 未 来 
物品 所 需 携带 的 资料 量 会 越 来 越 大 ， 对 卷 标 所 能 扩充 容量 的 需求 也 相应 增加 。 

Q 安全 性 : 由 于 RFID 承 载 的 是 电子 式 信息 ， 其 数据 内 容 可 经 由 密码 保护 ， 使 其 内 容 不 易 被 伪造 
及 变 造 。 

RFID 因 其 所 具备 的 远 距离 读 取 、 高 存储 量 等 特性 而 备 受 瞩 目 。 它 不 仅 可 以 帮助 一 个 企业 大 幅 提 高 

货物 、 信 息 管理 的 效率 ， 还 可 以 让 销售 企业 和 制造 企业 互联 ， 从 而 更 加 准确 地 接收 反馈 信息 ， 控 制 需 
求 信息 ， 优 化 整个 供应 链 。 


7.24 RFID 技术 的 工作 原理 


RFID 技术 的 基本 工作 原理 是 : 当 标 签 进入 磁场 后 ， 接 收 解读 器 发 出 的 射频 信号 ， 凭 借 感 应 电流 所 
获得 的 能 量 发 送出 存储 在 芯片 中 的 产品 信息 (Passive Tag， 无 源 标签 或 被 动 标签 )， 或 者 由 标签 主动 发 
送 某 一 频率 的 信号 CActive Tag， 有 源 标签 或 主动 标签 )， 解 读 器 读 取信 息 并 解码 后 ， 送 至 中 央 信息 系 
统 进 行 有 关 数 据 处 理 。 

一 套 完整 的 RFID 系统 ,是 由 阅读 器 (Reader) 与 电子 标签 (TAG ) 也 就 是 所 谓 的 应 答 器 (Transponder) 
及 应 用 软件 系统 3 个 部 分 所 组 成 ,其 工作 原理 是 Reader 发 射 一 特定 频率 的 无 线 电波 能 量 给 Transponder, 
用 以 驱动 Transponder 电路 将 内 部 的 数据 送出 ， 此 时 Reader 便 依 序 接收 解读 数据 ， 送 给 应 用 程序 做 相 
应 的 处 理 。 

以 RFID 卡片 阅读 器 及 电子 标签 之 间 的 通信 及 能 量 感 应 方式 来 看 , 可 以 大 致 将 RFID 分 成 感应 耦合 

(Inductive Coupling) 及 后 向 散射 耦合 CBackscatter Coupling) 两 种 。 通 常 低频 的 RFID 大 都 采用 第 一 
种 方式 ， 而 较 高 频 大 多 采用 第 二 种 方式 。 

阅读 器 根据 使 用 的 结构 和 技术 不 同 可 以 是 读 或 读 / 写 装置 ， 是 RFID 系统 信息 控制 和 处 理 中 心 。 阅 

读 器 通常 由 耦合 模块 、 收 发 模块 、 控 制 模块 和 接口 单元 组 成 。 阅 读 器 和 应 答 器 之 间 一 般 采 用 半 双 工 通 
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信 方 式 进行 信息 交换 ， 同 时 阅读 器 通过 耦合 给 无 源 应 答 器 提供 能 量 和 时 序 。 在 实际 应 用 中 ， 可 进一步 
通过 Ethemet 或 WLAN 等 实现 对 物体 识别 信息 的 采集 、 处 理 及 远程 传送 等 管理 功能 。 应 答 器 是 RFID 
系统 的 信息 载体 ， 应 答 器 大 多 是 由 耦合 原件 线圈、 微 带 天 线 等 ) 和 微 芯 片 组 成 无 源 单元 。 
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ШМ 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 7 章 \Android 系统 中 的 NFC.avi 

МЕС 通信 总 是 由 一 个 发 起 者 (Initiator) 和 一 个 接受 者 (Target) 组 成 ,通常 Initiator 主动 发 送 电磁 
J (RF) 可 以 为 被 动 式 接受 者 (Passive Target) 提供 电源 ， 其 工作 的 基本 原理 和 收音 机 类 似 。 正 是 由 
于 被 动 式 接受 者 可 以 通过 发 起 者 提供 电源 , 因此 Target 可 以 有 非常 简单 的 形式 , 比如 标签 、 卡 和 Sticker 
的 形式 。 另 外 , NFC 也 支持 点 到 点 的 通信 (Peer to Peer), 此 时 参与 通信 的 双方 都 有 电源 支持 。 ТЕ Android 
系统 的 NFC 模块 应 用 中 , Android 手机 通常 是 作为 通信 中 的 发 起 者 ,也 就 是 作为 NFC 的 读 写 器 。Android 
手机 也 可 以 模拟 作为 NFC 通信 的 接受 者 ， 并 且 从 Android 2.3.3 起 也 支持 P2P 通信 。Android 系统 支持 
如 下 的 NFC 标准 。 

О NfcANFC-A (ISO 14443-3A) 
NfcBNFC-B (ISO 14443-3B) 
NfcFNFC-F (JIS 6319-4) 
NfcVNFC-V (ISO 15693) 
IsoDepISO-DEP (ISO 14443-4) 
MifareClassic 
MifareUltralight 
在 Android 系统 中 ，NFC 模块 从 上 到 下 的 结构 如 图 7-1 所 示 。 


— ----- /system/framework/framework.jar-—— 


a 
a 
a 
a 
a 
a 


android.nfc 标准 接口 (NFCAdapter/NfcManager) 
android.nfc.tech 标签 技术 


-一 -一 一 -一 -一 一 人 System/Nfc.apk- 一 -一 一 -一 -一 一 -一 


com.android.nfc МЕС 服务 相关 
.DeviceHost 底层 设备 接口 原型 
.NfcService Nfc 服务 实现 DeviceHostListener 接口 
com.android.nfc.dhimpl NFC 功能 底层 实现 -com.android.nfc.DeviceHost (NXP) 
.NativeNfcManager implements DeviceHost 
JNI-> com android nfc NativeNfcManager.cpp (libnfc jni.so) 
-NativeNfcSecureElement 
JNI-> com android nfc NativeNfcSecureElement.cpp (libnfc jni.so) 


Isystem/lib/libnfc ^ .so——--—- 


libnfc-nxp => libnfc.so, libnfc ndef.so 
libnfc-nci => libnfc-nci.so 


7-1 NFC 模块 从 上 到 下 的 结构 
在 本 节 的 内 容 中 ， 将 详细 讲解 Android 系统 中 МЕС 模块 源码 的 基本 知识 。 


(i, 
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7.3.1 分 析 Java E 


在 Android 系统 中 ，NFC 模块 的 Java 层 代 码 位 于 如 下 所 示 的 目录 中 。 

\frameworks\base\core\java\android\nfc\ 

在 上 述 目 录 中 ,包含 了 用 来 与 本 地 NFC 适配器 进行 交互 的 顶层 类 ,这 些 类 可 以 表示 被 检测 到 的 tags 
和 用 NDEF 数据 格式 。 在 МЕС 的 Java 层 中 ， 常 用 的 顶层 类 如 下 。 

(1) NfcManager 类 

Ж NfcManager fE Ж. (frameworks base core java android nfcNfcManager.java 中 定义 ,这 是 一 个 NFC 
Adapter 的 管理 器 ， 可 以 列 出 所 有 此 Android 设备 支持 的 NFC Adapter， 只 不 过 大 部 分 Android 设备 只 
有 一 个 NFC Adapter, 所 以 在 大 部 分 情况 下 可 以 直接 用 静态 方法 getDefaultAdapter(context) 来 取 适 配器 。 
文件 \frameworks\base\core\java\androidnfc\NfcManager.java 的 具体 实现 代码 如 下 所 示 。 


public final class NfcManager { 
private final NfcAdapter mAdapter; 


fa 
* @hide 
ч 
public NfcManager(Context context) { 
NfcAdapter adapter; 
context = context.getApplicationContext(); 
if (context == null) { 
throw new IllegalArgumentException( 
"context not associated with any application (using a mock context?)"); 
} 
try f 
adapter = NfcAdapter.getNfcAdapter(context); 
} catch (UnsupportedOperationException e) { 
adapter = null; 
} 
mAdapter = adapter; 
} 


p 
* Get the default NFC Adapter for this device. 
* @return the default МЕС Adapter 
«ii 
public NfcAdapter getDefaultAdapter() { 
return mAdapter; 
) 
) 
(2) NfcAdapter 类 
类 NfcAdapter TE X fT frameworks base core java'android nfeNfcA dapter.java 中 定义 ， 此 类 表示 本 设 
备 的 NFC Adapter， 可 以 定义 Intent 来 请 求 将 系统 检测 到 tags 的 提醒 发 送 到 我 们 的 Activity， 并 提供 方 
法 去 注册 前 台 tag 提醒 发 布 和 前 台 NDEF 推送 。 前 台 NDEF 推送 是 当前 Android 版 本 唯一 支持 的 p2p 


157 


E Android 外 设 开发 实战 


МЕС 通信 和 方式。 文件 \frameworks\base\core\java\android\nfc\NfcAdapter.java 的 具体 实现 代码 如 下 所 示 。 
public final class NfcAdapter { 
static final String TAG = "NFC"; 
public static final String ACTION_NDEF_DISCOVERED = "android.nfc.action.NDEF_DISCOVERED"; 
@SdkConstant(SdkConstantType.ACTIVITY INTENT ACTION) 
public static final String ACTION_TECH_DISCOVERED = "android.nfc.action. TECH_DISCOVERED"; 
@SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION) 
public static final String ACTION TAG DISCOVERED = “android.nfc.action.TAG DISCOVERED"; 
public static final String ACTION TAG LEFT FIELD = "android.nfc.action. TAG LOST"; 
public static final String EXTRA ТАС = "android.nfc.extra. TAG"; 
public static final String EXTRA NDEF MESSAGES = "android.nfc.extra. NDEF MESSAGES"; 
public static final String EXTRA 10 = "android.nfc.extra.ID"; 
(SdkConstant(SdkConstantType.BROADCAST INTENT ACTION) 
public static final String ACTION ADAPTER STATE CHANGED = 
"android.nfc.action.ADAPTER STATE CHANGED"; 
public static final String EXTRA ADAPTER STATE - "android.nfc.extra.ADAPTER STATE"; 


public static final int STATE OFF = 1; 

public static final int STATE TURNING ON = 2; 
public static final int STATE ON 7 3; 

public static final int STATE TURNING OFF = 4; 


/** @hide */ 
public static final int FLAG NDEF PUSH NO CONFIRM = 0х1; 


I** @hide */ 
public static final String ACTION HANDOVER_TRANSFER_STARTED = 
"android.nfc.action HANDOVER TRANSFER STARTED"; 


[** @hide */ 
public static final String ACTION HANDOVER_TRANSFER_DONE = 
"android.nfc.action HANDOVER_TRANSFER_DONE"; 


~ @hide */ 
public static final String EXTRA HANDOVER TRANSFER STATUS = 
"android.nfc.extra HANDOVER TRANSFER STATUS"; 


[** @hide */ 

public static final int HANDOVER TRANSFER STATUS SUCCESS = 0; 

I** @hide */ 

public static final int HANDOVER TRANSFER STATUS FAILURE = 1; 

I** @hide */ 

public static final String EXTRA_HANDOVER_TRANSFER_URI = 
"android.nfc.extraHANDOVER TRANSFER URI"; 


11 Guarded by NfcAdapter.class 
static boolean slslnitialized = false; 


II Final after first constructor, except for 
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II attemptDeadServiceRecovery() when NFC crashes - we accept a best effort 

11 recovery 

static INfcAdapter sService; 

static INfcTag sTagService; 

static HashMap<Context, NfcAdapter> sNfcAdapters = new HashMap(); //guard by NfcAdapter.class 
static NfcAdapter sNullContextNfcAdapter; // protected by NfcAdapter.class 


final NfcActivityManager mNfcActivityManager; 
final Context mContext; 
public interface OnNdefPushCompleteCallback { 
public void onNdefPushComplete(NfcEvent event); 
} 
public interface CreateNdefMessageCallback { 
public NdefMessage createNdefMessage(NfcEvent event); 
} 
11 TODO javadoc 
public interface CreateBeamUrisCallback { 
public Uri[ ] createBeamUris(NfcEvent event); 
} 
private static boolean hasNfcFeature() { 
IPackageManager pm = Activity Thread.getPackageManager(); 
if (pm == null) ( 
Log.e(TAG, "Cannot get package manager, assuming no NFC feature"); 
return false; 
} 
try { 
return pm.hasSystemFeature(PackageManager.FEATURE NFC); 
} catch (RemoteException e) ( 
Log.e(TAG, "Package manager query failed, assuming no NFC feature", e); 
return false; 
) 
) 
public static synchronized NfcAdapter getNfcAdapter(Context context) { 
if (!slsInitialized) { 
/* is this device meant to have NFC */ 
if (IhasNfcFeature()) { 
Log.v(TAG, "this device does not have NFC support"); 
throw new UnsupportedOperationException(); 
} 


sService = getServicelnterface(); 

if (SService == null) { 
Log.e(TAG, "could not retrieve NFC service"); 
throw new UnsupportedOperationException(); 

} 

try { 
sTagService = sService.getNfcTagInterface(); 

} catch (RemoteException e) { 
Log.e(TAG, "could not retrieve NFC Tag service"); 
throw new UnsupportedOperationException(); 
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slslnitialized = true; 
} 
if (context == null) { 
if (sNullContextNfcAdapter == null) { 
sNullContextNfcAdapter = new NfcAdapter(null); 
} 
return sNullContextNfcAdapter; 
} 
NfcAdapter adapter = sNfcAdapters.get(context); 
if (adapter == null) { 
adapter = new NfcAdapter(context); 
sNfcAdapters.put(context, adapter); 
} 
return adapter; 


} 


/** get handle to NFC service interface */ 
private static INfcAdapter getServicelnterface() { 
/* get a handle to NFC service */ 
IBinder b = ServiceManager.getService("nfc"); 
if (b == null) { 
return null; 
} 
return INfcAdapter.Stub.asinterface(b); 
} 
public static NfcAdapter getDefaultAdapter(Context context) { 
if (context == null) { 
throw new Illegal[ArgumentException("context cannot be null"); 
} 
context = context.getApplicationContext(); 
if (context == null) { 
throw new IllegalArgumentException( 
"context not associated with any application (using a mock context?)"); 
) 
/* use getSystemService() for consistency */ 
NfcManager manager = (NfcManager) context.getSystemService(Context.NFC SERVICE); 
if (manager == null) ( 
II NFC not available 


return null; 
) 
return manager.getDefaultAdapter(); 
} 
@Deprecated 


public static NfcAdapter getDefaultAdapter() { 
ll introduced іп API version 9 (GB 2.3) 
1/ deprecated in API version 10 (GB 2.3.3) 
ll removed from public API in version 16 (ICS MR2) 
II should maintain as a hidden API for binary compatibility for a little longer 
Log.w(TAG, "WARNING: NfcAdapter.getDefaultAdapter() is deprecated, use " + 
"NfcAdapter.getDefaultAdapter(Context) instead", new Exception()); 


@ 
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return NfcAdapter.getNfcAdapter(null); 


} 
public boolean isEnabled() { 

try{ 
return sService.getState() == STATE_ON; 

} catch (RemoteException e) { 
attemptDeadServiceRecovery(e); 
return false; 

} 

} 
public int getAdapterState() { 

try { 
return sService.getState(); 

} catch (RemoteException e) { 
attemptDeadServiceRecovery(e); 
return NfcAdapter.STATE_OFF; 

} 

} 
public boolean enable() { 

try( 
return sService.enable(); 

} catch (RemoteException e) ( 
attemptDeadServiceRecovery(e); 
return false; 

} 

} 
public boolean disable() { 

try( 
return sService.disable(true); 

} catch (RemoteException e) ( 
attemptDeadServiceRecovery(e); 
return false; 

} 

} 


public void setBeamPushUris(Uri[ ] uris, Activity activity) { 
if (activity == null) { 
throw new NullPointerException("activity cannot be null"); 
) 
if (uris != null) { 
for (Uri uri : uris) ( 
if (uri == null) throw new NullPointerException("Uri not " + 
“allowed to be null"); 
String scheme = uri.getScheme(); 
if (scheme == null || (!'scheme.equalslgnoreCase("file") && 
!scheme.equalslgnoreCase(“content"))) { 
throw new IIlegalArgumentException("URI needs to have " + 
“either scheme file or scheme content"); 
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} 
mNfcActivityManager.setNdefPushContentUri(activity, uris); 
} 
public void setBeamPushUrisCallback(CreateBeamUrisCallback callback, Activity activity) { 
if (activity == null) { 
throw new NullPointerException("activity cannot be null"); 
} 
mNfcActivityManager.setNdefPushContentUriCallback(activity, callback); 
} 
public void setNdefPushMessage(NdefMessage message, Activity activity, 
Activity ... activities) { 
int targetSdkVersion = getSdkVersion(); 
try { 
if (activity == null) { 
throw new NullPointerException("activity cannot be null"); 
} 
mNfcActivityManager.setNdefPushMessage(activity, message, 0); 
for (Activity a : activities) { 
if (a == null) { 
throw new NullPointerException("activities cannot contain null"); 
} 
mNfcActivityManager.setNdefPushMessage(a, message, 0); 
} 
} catch (IllegalStateException e) ( 
if (targetSdkVersion « android.os.Build. VERSION CODES.JELLY BEAN)( 
II Less strict on old applications - just log the error 
Log.e(TAG, "Cannot call АР! with Activity that has already " + 
"been destroyed", e); 


) else { 
// Prevent new applications from making this mistake, re-throw 
throw(e); 
} 
} 
} 
p 
* (hide 


E 
public void setNdefPushMessage(NdefMessage message, Activity activity, int flags) ( 
if (activity == null) ( 
throw new NullPointerException("activity cannot be null"); 
) 
mNfcActivityManager.setNdefPushMessage(activity, message, flags); 
} 
public void setNdefPushMessageCallback(CreateNdefMessageCallback callback, Activity activity, 
Activity ... activities) { 
int targetSdkVersion = getSdkVersion(); 
try { 
if (activity == null) { 
throw new NullPointerException("activity cannot be null"); 
} 
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mNfcActivityManager.setNdefPushMessageCallback(activity, callback, 0); 
for (Activity a : activities) { 
if (a == null) { 
throw new NullPointerException("activities cannot contain null"); 
H 
mNfcActivityManager.setNdefPushMessageCallback(a, callback, 0); 
} 
} catch (IllegalStateException e) { 
if (targetSdkVersion < android.os.Build. VERSION CODES.JELLY ВЕАМ№) { 
II Less strict on old applications - just log the error 
Log.e(TAG, "Cannot call АР! with Activity that has already " + 
"been destroyed", e); 


) else ( 
// Prevent new applications from making this mistake, re-throw 
throw(e); 
} 
} 
} 
public void setNdefPushMessageCallback(CreateNdefMessageCallback callback, Activity activity, 
int flags) { 
if (activity == null) { 
throw new NullPointerException("activity cannot be null"); 
} 
mNfcActivityManager.setNdefPushMessageCallback(activity, callback, flags); 
} 


public void setOnNdefPushCompleteCallback(OnNdefPushCompleteCallback callback, 
Activity activity, Activity ... activities) { 
int targetSdkVersion = getSdkVersion(); 
try( 
if (activity == null) { 
throw new NullPointerException("activity cannot be null"); 
} 
mNfcActivityManager.setOnNdefPushCompleteCallback(activity, callback); 
for (Activity a : activities) { 
if (a == null) { 
throw new NullPointerException("activities cannot contain null"); 
} 
mNfcActivityManager.setOnNdefPushCompleteCallback(a, callback); 
} 
} catch (IllegalStateException e) ( 
if (targetSdkVersion < android.os.Build. VERSION CODES.JELLY BEAN)( 
II Less strict on old applications - just log the error 
Log.e(TAG, "Cannot call API with Activity that has already " + 
"been destroyed", e); 


) else { 
// Prevent new applications from making this mistake, re-throw 
throw(e); 

} 


} 


} 
public void enableForegroundDispatch(Activity activity, PendingIntent intent, 
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IntentFilter[ ] filters, String[ ][ ] techLists) { 
if (activity == null || intent == null) { 
throw new NullPointerException(); 
} 
if (lactivity.isResumed()) { 
throw new IllegalStateException("Foreground dispatch can only be enabled " + 
"when your activity is resumed"); 


H 
try { 
TechListParcel parcel = null; 
if (techLists != null && techLists.length > 0) { 
parcel = new TechListParcel(techLists); 
} 
ActivityThread.currentActivity Thread().registerOnActivityPausedListener(activity, 
mForegroundDispatchListener); 
sService.setForegroundDispatch(intent, filters, parcel); 
} catch (RemoteException e) { 
attemptDeadServiceRecovery(e); 
} 


} 
public void disableForegroundDispatch(Activity activity) { 
ActivityThread.currentActivity Thread ().unregisterOnActivityPausedListener(activity, 
mForegroundDispatchListener); 
disableForegroundDispatchInternal(activity, false); 
} 
(3) NdefMessage #1 NdefRecord 类 
NDEF 是 NFC 论坛 定义 的 数据 结构 ， 用 来 将 有 效 的 存 数据 存储 到 NFC tags 中 ， 比 如 文本 、URL 
和 其 他 MIME 类 型 。 一 个 NdefMessage 扮演 一 个 容器 ， 这 个 容器 存储 那些 发 送 和 读 到 的 数据 。 一 个 
NdefMessage 对 象 包含 0 或 多 个 NdefRecord， 每 个 NDEF record 有 一 个 类 型 ， 比 如 文本 、URL、 智 慧 
型 海报 /广告 ， 或 其 他 MIME 数据 。 在 NdefMessage 中 的 第 一 个 NfcRecord 的 类 型 ， 功 能 是 发 送 tag 到 
一 个 Android 设备 上 的 Activity。 其 中 类 NdefMessage 在 文件 \frameworks\base\core\java\android\nfc\ 
NdefMessage.java 中 定义 ， 有 具体 实现 代码 如 下 所 示 。 
public final class NdefMessage implements Parcelable { 
private final NdefRecord[ ] mRecords; 
public NdefMessage(byte[ ] data) throws FormatException { 
if (data == null) throw new NullPointerException("data is null"); 
ByteBuffer buffer = ByteBuffer.wrap(data); 


mRecords = NdefRecord.parse(buffer, false); 


if (buffer.remaining() > 0) { 
throw new FormatException('trailing data"); 
H 
) 
public NdefMessage(NdefRecord record, NdefRecord ... records) ( 
II validate 


if (record == null) throw new NullPointerException("record cannot be null"); 


for (NdefRecord r : records) ( 


[OR 
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if (r== null) { 
throw new NullPointerException("record cannot be null"); 
} 
} 


mRecords = new NdefRecord[1 + records.length]; 
mRecords|0] = record; 
System.arraycopy(records, 0, mRecords, 1, records.length); 


} 
public NdefMessage(NdefRecord[ ] records) { 
II validate 
if (records.length < 1) { 
throw new IllegalArgumentException("must have at least one record"); 
} 
for (NdefRecord г: records) { 
if (r == null) { 
throw new NullPointerException("records cannot contain null"); 
} 
} 
mRecords = records; 
} 
public NdefRecord[ ] getRecords() { 
return mRecords; 
} 
public int getByteArrayLength() { 
int length = 0; 
for (NdefRecord г: mRecords) { 
length += r.getByteLength(); 
} 
return length; 
} 


public byte[ ] toByteArray() { 
int length = getByteArrayLength(); 
ByteBuffer buffer = ByteBuffer.allocate(length); 


for (int i=0; i<mRecords. length; i++) { 


boolean mb = (i == 0); // first record 
boolean me = (i == mRecords.length - 1); // last record 
mRecords[i].writeToByteBuffer(buffer, mb, me); 
} 
return buffer.array(); 
} 
@Override 
public int describeContents() { 
return 0; 
} 
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@Override 
public void writeToParcel(Parcel dest, int flags) { 


} 


dest.writelnt(mRecords.length); 
dest.writeTypedArray(mRecords, flags); 


public static final Parcelable. Creator<NdefMessage> CREATOR = 


new Parcelable.Creator<NdefMessage>() { 
@Override 
public NdefMessage createFromParcel(Parcel in) { 
int recordsLength = in.readint(); 
NdefRecord[ ] records = new NdefRecord[recordsLength]; 
in.readTypedArray(records, NdefRecord.CREATOR); 


return new NdefMessage(records); 
} 
@Override 
public NdefMessage[ ] newArray(int size) { 
return new NdefMessage[size]; 
} 
н 
@Override 


public int hashCode() { 


} 


return Arrays.hashCode(mRecords); 


@Override 
public boolean equals(Object obj) { 


} 


if (this == obj) return true; 

if (obj == null) return false; 

if (getClass() != obj.getClass()) return false; 
NdefMessage other = (NdefMessage) obj; 

return Arrays.equals(mRecords, other.mRecords); 


@Override 
public String toString() { 


} 
} 


return "NdefMessage " + Arrays.toString(mRecords); 


(4) Tag 类 
Ж Tag fE Ж ff frameworks base core java'android nfc Tag. java 中 定义 ,此 类 用 于 标示 一 个 被 动 的 NFC 
目标 ， 比 如 tag, card 和 钥匙 挂 扣 ， 甚 至 是 一 个 电话 模拟 的 NFC 卡 。 当 一 个 tag 被 检测 到 时 ， 一 个 tag 
对 象 将 被 创建 并 且 封 装 到 一 个 Intent 里 ， 然 后 NFC 发 布 系统 将 这 个 Intent 用 startActivity 发 送 到 注册 
了 接受 这 种 Intent 的 Activity 里 。 我 们 可 以 用 方法 getTechList() 来 得 到 这 个 tag 支持 的 技术 细节 ， 并 创 


建 一 个 android.nfe.tech 提供 的 相应 的 Tag Technology 对 象 。 文 件 Tag java 的 具体 实现 代码 如 下 所 示 。 
public final class Tag implements Parcelable { 
final byte[ ] mld; 
final int[ ] mTechList; 


@ 
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final String[ ] mTechStringList; 

final Bundle[ ] mTechExtras; 

final int mServiceHandle; // for use by NFC service, 0 indicates a mock 

final INfcTag mTagService; // interface to NFC service, will be null if mock tag 


int mConnectedTechnology; 
public Tag(byte[ ] id, int[ ] techList, Bundle[ ] techListExtras, int serviceHandle, 
INfcTag tagService) { 
if (techList == null) { 
throw new IllegalArgumentException("rawTargets cannot be null"); 
) 
mid = id; 
mTechList = Arrays.copyOf(techList, techList.length); 
mTechStringList = generateTechStringList(techList); 
11 Ensure mTechExtras is as long as mTechList 
mTechExtras 7 Arrays.copyOf(techListExtras, techList.length); 
mServiceHandle = serviceHandle; 
mTagService = tagService; 


mConnectedTechnology 7 -1; 

) 

public static Tag createMockTag(byte[ ] id, int[ ] techList, Bundle[ ] techListExtras) { 
II set serviceHandle to 0 and tagService to null to indicate mock tag 
return new Tag(id, techList, techListExtras, 0, null); 

} 

(5) “tech\” 子 目录 
除 此 之 外 ， 在 “frameworks\base\core\java\android\nfc\tech\” 目 录 中 包含 了 查询 tag 属性 和 进行 1/0 


操作 的 类 。 这 些 类 分 别 表示 一 个 tag 支持 的 不 同 的 NFC 技术 标准 ， 如 图 7-2 所 示 。 


rp Tr v Гао Ei 
By AR PEHR =- fe 
i| 名称“ 修改 日 其 类 型 大 小 

| Basi cTagTechnology. java 2013/8/14 9:20 JAVA 文件 5 КВ 

| IsoDep. java 2013/8/14 9:20 JAVA 文件 8 КВ 

L Mi fareClassic. java 2013/8/14 9:20 JAVA 文件 24 X 

L Mi farelltralight. java 2013/8/14 9:20 JAVA 文件 ию 

[Ù Ndef. java 2013/8/14 9:20 JAVA 文件 15 KB 

| Ndeffornatable. java 2013/8/14 9:20 JAVA 文件 тю 

НЕА. java 2013/8/14 9:20 JAVA 文件 6 КВ 

L U NfcB. java 2013/8/14 9:20 JAVA 文件 5 КВ 

[ | НёсВагсоде. java 2013/8/14 9:20 JAVA 文件 5 

目 Bc. java 2013/8/14 9:20 JAVA 文件 6 

[| несу. java 2013/8/14 9:20 JAVA 文件 5 

E) package. htnl 2013/8/14 9:20 HTML 文档 ію 

| TagTechnology. java 2013/8/14 9:20 JAVA 文件 9 K 


图 7-2  “frameworks\base\core\java\android\nfc\tech\” Н ж 


在 图 7-2 所 示 的 目录 中 ， 类 TagTechnology 是 如 表 7-2 中 所 有 TagTechnology 类 必须 实现 的 。 
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表 7-2 必须 实现 TagTechnology 的 类 


类 Xx — "m 
NfcA 支持 ISO 14443-3A 标准 的 操作 。Provides access to NFC-A (ISO 14443-3A) properties and I/O operations 
NfcB Provides access to NFC-B (ISO 14443-3B) properties and I/O operations 
NfcF Provides access to NFC-F (JIS 6319-4) properties and I/O operations 


NfcV Provides access to NFC-V (ISO 15693) properties and I/O operations 


IsoDep Provides access to ISO-DEP (ISO 14443-4) properties and I/O operations 
Ndef 提供 对 那些 被 格式 化 为 NDEF 的 tag 的 数据 的 访问 和 其 他 操作 


而 类 NdefFormatable 对 那些 可 以 被 格式 化 成 NDEF 格式 的 tag 提供 一 个 格式 化 的 操作 ， 文 件 
frameworks\base\core\java\android\nfe\tech\NdefFormatable.java 的 具体 实现 代码 如 下 所 示 。 
public final class NdefFormatable extends BasicTagTechnology { 
private static final String TAG = "NFC"; 
public static NdefFormatable get(Tag tag) { 
if (!tag.hasTech(TagTechnology.NDEF_FORMATABLE)) return null; 
try( 
return new NdefFormatable(tag); 
} catch (RemoteException e) ( 
return null; 


) 
} 
l'package*/ void format(NdefMessage firstMessage, boolean makeReadOnly) throws IOException, 
FormatException { 
checkConnected(); 


try { 
int serviceHandle = mTag.getServiceHandle(); 
INfcTag tagService = mTag.getTagService(); 
int errorCode = tagService.formatNdef(serviceHandle, MifareClassic.KEY_DEFAULT); 
switch (errorCode) { 
case ErrorCodes.SUCCESS: 
break; 
case ErrorCodes.ERROR_IO: 
throw new IOException(); 
case ErrorCodes.ERROR_INVALID_PARAM: 
throw new FormatException(); 
default: 
11 Should not happen 
throw new IOException(); 
5 
11 Now check and see if the format worked 
if (ItagService.isNdef(serviceHandle)) { 
throw new IOException(); 
} 


11 Write a message, if one was provided 

if (firstMessage != null) { 
errorCode = tagService.ndefWrite(serviceHandle, firstMessage); 
switch (errorCode) { 
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case ErrorCodes.SUCCESS: 
break; 
case ErrorCodes.ERROR_IO: 
throw new IOException(); 
case ErrorCodes.ERROR INVALID PARAM: 
throw new FormatException(); 
default: 
ll Should not happen 
throw new lOException(); 


} 


II optionally make read-only 
if (makeReadOnly) { 
errorCode = tagService.ndefMakeReadOnly(serviceHandle); 
switch (errorCode) ( 
case ErrorCodes.SUCCESS: 
break; 
case ErrorCodes.ERROR IO: 
throw new IOException(); 
case ErrorCodes.ERROR_INVALID_PARAM: 
throw new IOException(); 


default: 
11 Should not happen 
throw new lOException(); 
) 
) 
} catch (RemoteException e) { 


Log.e(TAG, "NFC service dead", e); 
} 
} 

} 

类 MifareClassic 在 文件 frameworks\base\core\java\android\nfe\tech\MifareClassic,java PEX, WR 
Android 设备 支持 MIFARE， 则 提供 对 MIFARE Classic 目标 的 属性 和 VO 操作 。 文 件 MifareClassic.java 
的 具体 实现 代码 如 下 所 示 。 

public final class MifareClassic extends BasicTagTechnology { 

private static final String TAG = "МЕС"; 
public static final byte[ ] KEY_DEFAULT = 
{(byte )OxFF (byte)OxFF (byte)OxFF ,(byte)OxFF (byte)OxFF, (byte )OxFF}; 
public static final byte[ ] KEY_MIFARE_APPLICATION_DIRECTORY = 
{(byte)0xA0, (byte)0xA1 ,(byte)0xA2,(byte)0xA3, (byte)0xA4 (byte )0xA5}; 
public static final byte] KEY МРС FORUM = 
((byte)OxD3, (byte) 0xF7, (byte)0xD3, (byte)OxF7, (byte)0xD3, (byte) 0xF7}; 


/** A MIFARE Classic compatible card of unknown type */ 
public static final int TYPE_UNKNOWN = -1; 

/** A MIFARE Classic tag */ 

public static final int TYPE_CLASSIC = 0; 

Ѓ* A MIFARE Plus tag */ 

public static final int TYPE_PLUS = 1; 


169 


Е Android 外 设 开发 实战 


Ѓ* A MIFARE Pro tag */ 
public static final int TYPE_PRO = 2; 


[** Tag contains 16 sectors, each with 4 blocks. */ 
public static final int SIZE_1K = 1024; 
[** Tag contains 32 sectors, each with 4 blocks. */ 
public static final int SIZE_2K = 2048; 
p 
* Tag contains 40 sectors. The first 32 sectors contain 4 blocks and the last 8 sectors 
* contain 16 blocks. 
dfi 
public static final int SIZE 4K = 4096; 
/** Tag contains 5 sectors, each with 4 blocks. */ 
public static final int SIZE MINI = 320; 


/** Size of a MIFARE Classic block (in bytes) */ 
public static final int BLOCK SIZE = 16; 


private static final int MAX BLOCK COUNT - 256; 
private static final int MAX SECTOR. COUNT = 40; 


private boolean mlsEmulated; 
private int mType; 
private int mSize; 
public static MifareClassic get(Tag tag) ( 
if (Itag.hasTech(TagTechnology.MIFARE CLASSIC)) retum null; 


try( 
return new MifareClassic(tag); 
} catch (RemoteException e) ( 
return null; 
) 
} 
~ @hide */ 


public MifareClassic(Tag tag) throws RemoteException { 
super(tag, TagTechnology.MIFARE_CLASSIC); 
МСА a = NfcA.get(tag); // MIFARE Classic is always based on NFC a 
mlsEmulated = false; 
switch (a.getSak()) { 
case 0x01: 
case 0x08: 
mType = TYPE_CLASSIC; 
mSize = SIZE_1K; 
break; 
case 0x09: 
mType = TYPE_CLASSIC; 
mSize = SIZE_MINI; 
break; 
case 0x10: 
mType = TYPE_PLUS; 
mSize = SIZE 2K; 
11 SecLevel = 512 
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break; 

case Ox11: 
mType = TYPE_PLUS; 
mSize = SIZE 4K; 
11 Seclevel = SL2 
break; 

case 0x18: 
mType = TYPE_CLASSIC; 
mSize = SIZE 4K; 
break; 

case 0x28: 
mType = TYPE_CLASSIC; 
mSize = SIZE 1K; 
mlsEmulated = true; 
break; 

case 0x38: 


mType = TYPE_CLASSIC; 
mSize = SIZE 4K; 
mlsEmulated = true; 
break; 
case 0x88: 
mType = TYPE CLASSIC; 
mSize = SIZE 1K; 
11 NXP-tag: false 
break; 
case 0x98: 
case 0хВ8: 
mType = TYPE PRO; 
mSize - SIZE 4K; 
break; 
default: 
II Stack incorrectly reported a MifareClassic. We cannot handle this 
II gracefully - we have no idea of the memory layout. Bail. 
throw new RuntimeException( 
"Tag incorrectly enumerated as MIFARE Classic, SAK =" + a.getSak()); 
} 
} 


类 MifareUltralight 在 文件 frameworks\base\core\java\android\nfe\tech\MifareUltralight.java 中 定义 ， 


WR Android 设备 支持 MIFARE， 则 提供 对 MIFARE Ultralight 目标 的 属性 和 1/0 操作 。 
public final class MifareUltralight extends BasicTagTechnology { 
private static final String TAG = "NFC"; 
/** A MIFARE Ultralight compatible tag of unknown type */ 
public static final int TYPE_UNKNOWN = -1; 
/** A MIFARE Ultralight tag */ 
public static final int TYPE_ULTRALIGHT = 1; 
/** A MIFARE Ultralight C tag */ 
public static final int TYPE_ULTRALIGHT_C = 2; 
[** Size of a MIFARE Ultralight page in bytes */ 
public static final int PAGE_SIZE = 4; 
private static final int МХР MANUFACTURER ID = 0x04; 
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private static final int MAX_PAGE_COUNT = 256; 
Р* @hide */ 
public static final String EXTRA IS UL C = "isulc"; 
private int mType; 
public static MifareUltralight get(Tag tag) { 
if (Itag.hasTech(TagTechnology.MIFARE ULTRALIGHT)) return null; 
try { 
return new MifareUltralight(tag); 
) catch (RemoteException e) ( 
return null; 
} 
} 
~ @hide */ 
public MifareUltralight(Tag tag) throws RemoteException ( 
super(tag, TagTechnology.MIFARE ULTRALIGHT); 
II Check if this could actually be a MIFARE 
NfcA a 7 NfcA.get(tag); 
mType = TYPE UNKNOWN; 
if (a.getSak() == 0x00 && tag.getld()[0] == МХР MANUFACTURER 10) { 
Bundle extras = tag.getTechExtras(TagTechnology.MIFARE ULTRALIGHT); 
if (extras.getBoolean(EXTRA IS UL C))( 
mType = TYPE ULTRALIGHT C; 
) else { 
mType = TYPE_ULTRALIGHT; 
} 
} 
} 
public byte[ ] readPages(int pageOffset) throws IOException { 
validatePagelndex(pageOffset); 
checkConnected(); 


byte[ ] cmd = ( 0x30, (byte) pageOffset}; 
return transceive(cmd, false); 
) 
public void writePage(int pageOffset, byte[ ] data) throws IOException { 
validatePagelndex(pageOffset); 
checkConnected(); 
byte[ ] cmd = new byte[data.length + 2]; 
cmd[0] = (byte) 0xA2; 
cmd[1] = (byte) pageOffset; 
System.arraycopy(data, 0, cmd, 2, data.length); 
transceive(cmd, false); 
} 
public void setTimeout(int timeout) { 
try{ 
int err = mTag.getTagService().setTimeout( 
TagTechnology.MIFARE_ULTRALIGHT, timeout); 
if (err != ErrorCodes.SUCCESS) { 
throw new IllegalArgumentException("The supplied timeout is not valid"); 
} 
) catch (RemoteException e) { 
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Log.e(TAG, "МЕС service dead", е); 


} 
} 
public int getTimeout() { 
try { 
return mTag.getTagService().getTimeout(TagTechnology.MIFARE ULTRALIGHT); 
} catch (RemoteException e) ( 
Log.e(TAG, "NFC service dead", e); 
return 0; 
) 
) 


private static void validatePageIndex(int pagelndex) { 
II Do not be too strict on upper bounds checking, since some cards 
1/ may have more addressable memory than they report. 
11 Note that issuing a command to an out-of-bounds block is safe - the 
II tag will wrap the read to an addressable area. This validation is a 
II helper to guard against obvious programming mistakes. 
if (pagelndex < 0 || pagelndex >= MAX PAGE COUNT) { 
throw new IndexOutOfBoundsException("page out of bounds: " * pagelndex); 
) 


} 
7.32 分 析 ЈМ 部 分 


在 Android 系统 中 ，NFC 模块 的 JNI 部 分 代码 通过 如 下 所 示 的 目录 中 实现 。 

\packages\apps\Nfc\nxp\jni 

INI 部 分 代码 向 上 会 跟 Framework 层 的 Java 代码 进行 交互 , 向 下 会 跟 libnfe 层 进行 交互 。 JNI 层 的 
核心 文件 是 com_android_nfe_ NativeNfcManagercpp, 功能 是 初始 化 并 启动 NFC 服务 ,并 扫描 和 读 取 tago 
文件 com android пёс NativeNfeManager.cpp 的 主要 实现 代码 如 下 所 示 。 

static void client_kill_deferred_call(void* arg) 


{ 


struct nfc_jni_native_data *nat = (struct nfc_jni_native_data *)arg; 


nat->running = FALSE; 
} 


static void kill_client(nfc_jni_native_data *nat) 

i phDal4Nfc Message Wrapper t wrapper; 
phLibNfc DeferredCall t *pMsg; 
usleep(50000); 

ALOGD("Terminating client thread..."); 


pMsg = (phLibNfc DeferredCall t*)malloc(sizeof(phLibNfc DeferredCall t)); 
pMsg->pCallback = client kill deferred call; 
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pMsg->pParameter = (void*)nat; 


wrapper.msg.eMsgType = PH LIBNFC DEFERREDCALL MSG; 
wrapper.msg.pMsgData = pMsg; 
wrapper.msg.Size = sizeof(phLibNfc DeferredCall t); 


phDal4Nfc msgsnd(gDrvCfg.nClientld, (struct msgbuf *)&wrapper, sizeof(phLibNfc Message t), 0); 
) 


Static void nfc jni ioctl callback(void *pContext, phNfc_sData_t *pOutput, NFCSTATUS status) ( 
struct піс jni callback data * pCallbackData = (struct nfc jni callback data *) pContext; 
LOG CALLBACK("nfc jni ioctl callback", status); 


/* Report the callback status and wake up the caller */ 
pCallbackData->status = status; 
sem_post(&pCallbackData->sem); 

} 


Static void nfc_jni_deinit_download_callback(void *pContext, NFCSTATUS status) 

{ 
struct nfc_jni_callback_data * pCallbackData = (struct nfc_jni_callback_data *) pContext; 
LOG CALLBACK("nfc jni deinit download callback", status); 


/* Report the callback status and wake up the caller */ 
pCallbackData->status = status; 
sem_post(&pCallbackData->sem); 

} 


static int nfc jni download locked(struct nfc_jni_native_data *nat, uint8_t update) 
{ 

uint8 t OutputBuffer[1]; 

uint8 t InputBuffer[1]; 

Struct timespec ts; 

NFCSTATUS status - NFCSTATUS FAILED; 

phLibNfc StackCapabilities t caps; 

struct nfc jni callback data cb data; 

bool result; 


/* Create the local semaphore */ 
if (Infc cb data init(&cb data, NULL)) 
К 

goto clean and return; 


} 


if(update) 
{ 
IIdeinit 
TRACE("phLibNfc Mgt Delnitialize() (download)"); 
REENTRANCE_LOCK(); 
status = phLibNfc_Mgt_Delnitialize(gHWRef, nfc jni deinit download callback, (void *)&cb_data); 


174 


第 7 章 NFC 近 场 通信 am 


REENTRANCE_UNLOCK(); 
if (status = NFCSTATUS_PENDING) 


{ 
ALOGE("phLibNfc_Mgt_Delnitialize() (download) returned 0x%04x[%s]", status, nfc_jni_get_ 
status name(status)); 


} 


clock_gettime(CLOCK_REALTIME, &ts); 
ts.tv_sec += 5; 


/* Wait for callback response */ 
if(sem_timedwait(&cb_data.sem, &ts)) 


{ 

ALOGW("Deinitialization timed out (download)"); 
} 
if(cb_data.status != NFCSTATUS_SUCCESS) 
{ 

ALOGW("Deinitialization FAILED (download)"); 
} 


TRACE("Deinitialization SUCCESS (download)"); 
} 


result = performDownload(nat, false); 


if (!result) { 
status = NFCSTATUS_FAILED; 
goto clean_and_return; 


} 


TRACE("phLibNfc Mgt Initialize()"); 
REENTRANCE LOCK(); 
status = phLibNfc Mgt Initialize(gHWRef, nfc jni init callback, (void *)&cb data); 
REENTRANCE UNLOCK(); 
if(status != NFCSTATUS PENDING) 
{ 
ALOGE("phLibNfc Mgt Initialize() (download) retumed 0x%04x{%s]", status, nfc_jni_get_status_name(status)); 
goto clean_and_return; 


} 
TRACE("phLibNfc Моќ Initialize() returned 0х%04х[%5]", status, піс jni get status name(status)); 


(вет wait(&cb data.sem)) 

{ 
ALOGE("Failed to wait for semaphore (errno=0x%08x)", errno); 
status = NFCSTATUS FAILED; 
goto clean and return; 


) 


f Initialization Status */ 
if(cb_data.status |= NFCSTATUS SUCCESS) 
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status = cb_data.status; 
goto clean and retum; 


REENTRANCE LOCK(); 
status = phLibNfc Mgt GetstackCapabilities(&caps, (void*)nat); 
REENTRANCE UNLOCK(); 
if (status != NFCSTATUS SUCCESS) 
{ 
ALOGW("phLibNfc_Mgt_GetstackCapabilities returned 0x%04x[%s]", status, nfc_jni_get_status_name(status)); 


else 
{ 
ALOGD("NFC capabilities: HAL = %x, FW = 96x, HW = %x, Model = %x, НСІ = %x, Full FW = 96d, Rev 
= %а, FW Update Info = %d", 

caps.psDevCapabilities.hal_version, 
caps.psDevCapabilities.fw_version, 
caps.psDevCapabilities.hw_version, 
caps.psDevCapabilities.model id, 
caps.psDevCapabilities.hci version, 
caps.psDevCapabilities.full versioni NXP FULL VERSION LEN-1], 
caps.psDevCapabilities.full уегѕіоп[МХР FULL VERSION LEN-2], 
caps.psDevCapabilities.firmware update info); 


} 


/*Download is successful*/ 
status = NFCSTATUS_SUCCESS; 


clean_and_return: 
nfc_cb_data_deinit(&cb_data); 
гейт status; 


} 


static int піс jni configure driver(struct піс jni native data *nat) 
{ 

char value[PROPERTY VALUE MAX]; 

int result = FALSE; 

NFCSTATUS status; 


/* Configure hardware link */ 
gDrvCfg.nClientld = phDal4Nfc_msgget(0, 0600); 


TRACE("phLibNfc Mgt ConfigureDriver(0x?608x)", gDrvCfg.nClientld); 
REENTRANCE LOCK(); 
status = phLibNfc_Mgt_ConfigureDriver(&gDrvCfg, &gHWRef); 
REENTRANCE_UNLOCK(); 
if(status == NFCSTATUS ALREADY INITIALISED) { 
ALOGW('phLibNfc Mgt ConfigureDriver() returned 0x%04x{%s]", status, nfc_jni_get_status_name(status)); 
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} 
else if(status = NFCSTATUS SUCCESS) 


{ 
ALOGE("phLibNfc_Mgt_ConfigureDriver() returned 0x%04x[%s]", status, nfc_jni_get_status_name(status)); 
goto clean_and_return; 


} 
TRACE("phLibNfc_Mgt_ConfigureDriver() returned 0x%04x{%s]", status, nfc_jni_get_status_name(status)); 


if(pthread_create(&(nat->thread), NULL, nfc_jni_client_thread, nat) != 0) 
{ 

ALOGE("pthread_create failed"); 

goto clean and retum; 


} 
driverConfigured = TRUE; 


clean_and_return: 
return result; 


} 


static int nfc_jni_unconfigure_driver(struct nfc jni native data *nat) 
{ 

int result = FALSE; 

NFCSTATUS status; 


/* Unconfigure driver */ 
TRACE("phLibNfc_Mgt_UnConfigureDriver()"); 
REENTRANCE_LOCK(); 
status = phLibNfc_Mgt_UnConfigureDriver(gHWRef); 
REENTRANCE UNLOCK(); 
if(status = NFCSTATUS SUCCESS) 
{ 
ALOGE("phLibNfc Mgt UnConfigureDriver() returned error 0x%04x[%s] — this should never happen", 
status, nfc_jni_get_status_name( status)); 
} 
else 
{ 
ALOGD("phLibNfc_Mgt_UnConfigureDriver() returned 0x%04x[%s]", status, піс jni get status name 
(status)); 
result = TRUE; 
} 


driverConfigured = FALSE; 


return result; 


} 
733 ”分析 底层 


在 Android 系统 中 ，NFC 模块 的 底层 部 分 有 驱动 部 分 和 libnfe 库 部 分 两 大 类 。 驱 动 部 分 在 device 
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目录 中 实现 ， 例 如 device\samsung\tuna\nfe 目录 中 保存 了 设备 厂家 三 星 电 子 提供 的 hardware lib. ifj 
libnfc-nci 和 libnfe-nxp 目录 中 的 底层 文件 则 负责 NFC 数据 的 读 取 和 解析 工作 。 


7.4 在 Android 系统 编写 NFC APP 的 方法 


ШЫ 知 识 点 讲解 :光盘 :视频 \ 知 识 点 第 7 EVE Android 系统 编写 NFC APP 的 方法 .avi 

当 Android 手机 开启 了 NFC 程序 ， 并 且 检 测 到 一 个 TAG 后 ，TAG 分 发 系统 会 自动 创建 一 个 封装 
了 NFC TAG 信息 的 Intent。 如 果 多 于 一 个 应 用 程序 能 够 处 理 这 个 Intent， 那 么 手机 就 会 弹出 一 个 对 话 
框 ， 让 用 户 选 择 处 理 该 TAG 的 Activity。 在 TAG 分 发 系统 中 定义 了 3 种 Intent， 按 优先 级 从 高 到 低 排 
列 顺序 依次 是 : 

Q NDEF DISCOVERED 

Q TECH DISCOVERED 

Q TAG DISCOVERED 
4 Android 设备 检测 到 有 МЕС Tag 靠近 时 ， 会 根据 Action 申明 的 顺序 给 对 应 的 Activity 发 送 含 
NFC 消息 的 Intent。 此 处 我 们 使 用 的 intent-filter 的 Action 类 型 为 TECH DISCOVERED， 从 而 可 以 处 
理 所 有 类 型 为 ACTION_TECH_DISCOVERED， 并 且 使 用 的 技术 为 nfe_tech_filterxml 文件 中 定义 的 类 
型 的 TAG。 

当 Android 手机 检测 到 一 个 TAG 时 ， 启 用 Activity 的 匹配 过 程 如 图 7-3 所 示 。 


СЕЗЕ NDEF DISCOVERED | resins 


> H Yes 
| NDEF DISCOVERED? | 
| — ———— No 
M = zz 
| Activitiy registed to 
Unmapped or Non- à |. Intent delivered to 
юрен. [^4 TECH DISCOVERED Г тең | Yes ->| тө 
| L 
NEN No 
' = = 
| Activities registered to | 
| TAG DISCOVERED = еа 
TAG_DISCOVERED 


7-3 启用 Activity 的 匹配 过 程 


在 Android 系统 中 ， 编 写 NFC APP 的 基本 流程 如 下 。 

(1) 在 相关 的 androidManifest 文件 中 设置 NFC 权限 ， 具 体 代码 如 下 所 示 。 
<uses-permission android:name="android.permission.NFC" /> 

(2) WE SDK 的 级 别 限制 ， 例 如 设置 为 API 10. 
<uses-sdk android:minSdkVersion="10"/> 


(3) 声明 特殊 功能 的 限制 权限 ， 通 过 如 下 声明 可 以 让 应 用 程序 在 Google Play 上 声明 使 用 者 必须 
拥有 NFC 功能 。 
<uses-feature android:name="android.hardware.nfc" android:required="true" /> 
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(4) 实现 NFC 标签 过 滤 。 
在 Activity 的 Intent 过 滤 XML 声明 中 ， 可 以 同时 声明 过 滤 如 下 3 种 action (动作 ), 但 是 需要 提前 
知道 系统 在 发 送 Intent 时 拥有 的 优先 级 。 
О 动作 1: 过 滤 ACTION_TAG_DISCOVERED。 
<intent-filter> 
«action android:name="android.nfc.action. TAG_DISCOVERED"/> 
«category android:name="android.intent.category.DEFAULT"/> 
</intent-filter> 
这 个 最 简单 ， 也 是 最 后 一 个 被 尝试 接受 Intent 的 选项 。 
О 动作 2: 过 滤 ACTION_ NDEF DISCOVERED. 
<intent-filter> 
<action android:name="android.nfc.action.NDEF_DISCOVERED"/> 
«category android:name="android.intent.category.DEFAULT"/> 
«data android:mimeType="text/plain" /> 
</intent-filter> 
其 中 最 重要 的 是 data 的 mimeType 类 型 ,此 定义 越 准确 ,Intent 指向 这 个 Activity 的 成 功率 就 越 高 ， 
否则 系统 可 能 不 会 发 出 你 想 要 的 NDEF intent 了 。 
口 动作 3: 过 滤 ACTION_TECH_DISCOVERED。 
首先 需要 在 <project-path>/res/xml 下 面 创 建 一 个 过 滤 规 则 文件 ， 可 以 任意 命名 ， 例 如 可 以 叫做 
nfc_tech_filter.xml. 这 个 里 面 定义 的 是 МЕС 实现 的 各 种 标准 , 每 一 个 МЕС 卡 都 会 符合 多 个 不 同 的 标准 。 
可 以 在 检测 到 NFC 标签 后 ， 使 用 getTechList() 方 法 来 查看 所 检测 的 tag 到 底 支持 哪些 NFC 标准 。 在 一 
个 nfc tech filter.xml 文件 中 可 以 定义 多 个 <tech-list> 结 构 组 , 每 一 组 代表 声明 只 接受 同时 满足 这 些 标准 
的 NFC 标签 。 比 如 A 组 表示 ， 只 有 同时 满足 IsoDep. NfcA. NfcB. МЕЕ 这 4 个 标准 的 NFC 标签 的 
Intent 才能 进入 。A 与 B 组 之 间 的 关系 就 是 只 要 满足 其 中 一 个 就 可 以 了 。 换 名 话说， 我 们 的 NFC 标签 
技术 满足 A 的 声明 也 可 以 ， 满 足 B 的 声明 也 可 以 。 
«resources xmins:xliff="um:oasis:names:tc:xliff:document:1.2"> 
<tech-list> ————— A £A 
<tech>android.nfc.tech.IsoDep</tech> <tech>android.nfc.tech.NfcA</tech>  <tech>android.nfc.tech.NfcB<#ech> 
<tech>android.nfc.tech.NfcF</tech> 
</tech-list> 
«tech-ist»————————————————————B ŁA 
<tech>android.nfc.tech.NfcV</tech> <tech>android.nfc.tech.Ndef</tech> <tech>android.nfc.tech.NdefFormatable</tech> 
<tech>android.nfc.tech.MifareClassic</tech> «tech»android.nfc.tech.MifareUltralight«/tech» 
</tech-list> 
</resources> 
在 androidManifest 文件 中 ， 声 明 xml 过 滤 的 举例 代码 如 下 所 示 。 
<activity> 
<intent-filter> 
«action android:name="android.nfc.action. TECH_DISCOVERED"/> 
</intent-filter> 
«meta-data android:name="android.nfc.action. TECH_DISCOVERED" 
android:resource="@xml/nfc_tech_filter" />——————- 这 个 就 是 你 的 资源 文件 名 
</activity> 
(5) @ МЕС 标签 的 前 台 分 发 系统 。 
什么 是 NFC 的 前 台 发 布 系统 ? 就 是 说 当 已 经 打开 我 们 的 应 用 的 时 候 ， 那 么 通过 这 个 前 台 发 布 系统 
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的 设置 ， 可 以 让 已 经 启动 的 Activity 拥有 更 高 的 优先 级 来 依据 在 代码 中 定义 的 标准 过 滤 和 处 理 Intent, 
而 不 是 让 其 他 声明 了 Intent Filter 的 Activity 来 干扰 , 甚至 连 自己 声明 在 文件 androidManifest 中 的 Intent 
Filter 都 不 会 来 干扰 。 也 就 是 说 ，foreground Dispatch 的 优先 级 大 于 intent filter。 此 时 有 如 下 两 种 情况 。 
О 第 一 种 情况 : 当 Activity 没 有 启动 的 时 候 去 扫描 tag， 那 么 系统 中 所 有 的 Intent Filter 都 将 一 起 参 
与 过 滤 。 
О 第 二 种 情况 : 当 Activity 启 动 去 扫描 tag 时 ， 那 么 将 直接 使 用 在 foreground dispatch 中 代码 写 入 的 
过 滤 标 准 。 如 果 这 个 标准 没有 命中 任何 Intent， 那 么 系统 将 使 用 所 有 Activity 声 明 的 Intent Filter 
xml 来 过 滤 。 
例如 ， 在 OnCreate 中 可 以 添加 如 下 所 示 的 代码 。 
II Create a generic Pendinglntent that will be deliver to this activity. The МЕС stack will fill in the intent with the 
details of the discovered tag before delivering to this activity. 
mPendingIntent = Pendinglntent.getActivity(this, 0, 
new Intent(this, getClass()).addFlags(Intent.FLAG ACTIVITY SINGLE TOP), 0); 
/做 一 个 IntentFilter 过 滤 你 想 要 的 action 这 里 过 滤 的 是 ndef 


IntentFilter ndef = new IntentFilter(NfcAdapter.ACTION_NDEF_DISCOVERED); 
/如果 对 action 的 定义 有 更 高 的 要 求 ， 比 如 data 的 要 求 ， 可 以 使 用 如 下 的 代码 来 定义 intentFilter 


1 try f 

I ndef.addDataType("*/*"); 

I } catch (MalformedMimeTypeException e) { 
I // TODO Auto-generated catch block 
II e.printStackTrace(); 


) 
// 生 成 intentFilter 
mFilters = new IntentFilter[ ] ( 
ndef, 


} 
/做 一 个 tech-list。 可 以 看 到 是 二 维 数据 ， 每 一 个 一 维 数组 之 间 的 关系 是 或 ， 但 是 一 个 一 维 数组 之 内 的 各 
个 项 就 是 与 的 关系 了 
mTechLists = new String[][]{ 
new String[ ] { NfcF.class.getName()}, 
new String[ ]{NfcA.class.getName()}, 
new String[ ]{NfcB.class.getName()}, 
new String[ ]{NfcV.class.getName()} 
y 
在 onPause 和 onResume 中 需要 加 入 如 下 相应 的 代码 。 
public void onPause() { 
super.onPause(); 
II ER. mAdapter.disableF oregroundDispatch( this); 
} 
public void onResume() { 
super.onResume(); 
// 设 定 intentfilter 和 tech-list 
/如 果 两 个 都 为 null 就 代表 优先 接收 任何 形式 的 TAG action 
/也 就 是 说 系统 会 主动 发 TAG intent 
mAdapter.enableForegroundDispatch(this, mPendingIntent, mFilters, mTechLists); 
} 
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Google Now 是 谷歌 在 VO 开发 者 大 会 上 随 安 卓 4.1 系统 同时 推出 的 一 款 应 用 ， 它 会 全 面 了 解 你 的 
各 种 习惯 和 正在 进行 的 动作 ， 并 利用 它 所 了 解 的 来 为 你 提供 相关 信息 。 本 章 将 详细 讲解 在 Android 设 
备 中 使 用 Google Now 技术 的 基本 知识 ， 为 学 习 本 书后 面 的 知识 打下 基础 。 
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Google Now 是 Google 在 移动 市 场 最 重要 的 创新 之 一 。 通 过 对 用 户 数据 的 挖掘 ，Google Now 在 
适当 的 时 刻 提供 适当 的 信息 ， 而 它 的 卡片 式 推送 也 代表 了 Google 展现 信息 的 新 方向 。 正 如 GigaOm 
的 作者 在 某 次 旅行 中 体会 到 的 ， Google Now 成 了 一 个 有 力 的 帮手 。 虽然 它 仍 有 些 让 人 不 安 , 但 Google 
Now REX T YE. 


8.1.1 搜索 引擎 的 升级 一 一 Google Now 


Google Now 功能 是 VO 大 会 上 的 一 个 亮点 ， 它 可 以 根据 不 同 使 用 习惯 来 帮 用 户 进行 多 项 信息 的 预 
测 ， 虽 然 人 机 交互 方面 与 iOS 上 的 Siri 还 有 很 大 差距 ， 但 其 预测 比 起 Siri 更 加 实用 。 国 外 媒体 都 给 了 
Google Now 功能 很 高 的 评价 ， 不 过 这 个 功能 在 中 国 受到 很 大 的 限制 。 

下 面 是 Reddit 网 站 网 友 对 Google Now 的 精彩 评论 : 这 是 笔者 与 Google Now 共处 的 第 一 天 ， 当 早 
上 醒 来 时 会 惊奇 地 发 现 Google Now 居然 直接 告诉 了 笔者 去 兼职 工作 的 路 上 所 要 花费 的 时 间 。 更 有 趣 的 
是 ， 笔 者 在 手机 中 保存 的 “工作 地 点 ”其 实 是 笔者 的 学 校 ， 而 不 是 笔者 真正 工作 的 地 方 ， 笔 者 只 能 认 
为 是 Google Now 发 现 了 笔者 每 个 周 日 都 会 去 那个 地 方 上 班 吧 。 

在 过 去 的 10 年 中 ， 搜 索引 擎 的 核心 是 获取 足够 多 的 海量 信息 ， 搜 索 技术 的 发 展 过 程 是 追赶 如 何 更 
好 地 获取 信息 的 过 程 ， 核 心 是 个 性 化 和 实时 信息 。 但 是 随 着 时 代 的 进步 和 发 展 ， 现 在 搜索 结果 正在 变 
得 越 来 越 个 性 化 。 不 同 的 人 都 会 看 到 他 更 感 兴趣 的 搜索 结果 ， 提 高 了 搜索 的 效率 ， 甚 至 由 于 搜索 变 得 
过 于 个 性 化 ， 人 们 获得 的 信息 都 是 自己 想 看 到 的 ， 从 而 让 原本 能 够 扩大 人 们 视野 的 搜索 变 成 了 把 人 们 
限制 在 自我 的 世界 工具 。 这 还 引发 了 关于 搜索 过 分 个 性 化 可 能 引发 的 次 端的 讨论 。 

搜索 在 个 性 化 方面 的 努力 最 重要 的 是 将 搜索 和 社交 网 络 结合 ， 这 样 搜索 引擎 就 能 获得 用 户 的 更 多 
信息 ， 从 而 更 好 地 帮 用 户 作 出 判断 。 在 个 性 化 搜索 方面 谷歌 遇 到 了 来 自 Facebook 的 挑战 ， 拥 有 最 多 
用 户 信息 的 网 站 是 Facebook， 但 它 却 并 不 向 谷歌 开放 。 从 某 种 程度 上 说 ， 谷 歌 推 出 自己 的 社交 网 络 
Google+ 的 核心 也 是 希望 获得 更 多 的 用 户 信息 。 

实时 搜索 更 多 是 搜索 在 技术 实现 上 的 改进 ， 当 然 ， 大 部 分 实时 信息 都 存在 于 Twitter 和 雅虎 ， 这 对 
谷歌 也 是 不 小 的 挑战 。 随 着 移动 互联 网 的 发 展 ， 位 置 也 成 为 了 搜索 引擎 提供 结果 的 重要 依据 ， 这 也 是 
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个 性 化 的 一 部 分 。 而 随 着 位 置信 息 的 加 入 ， 围 绕 这 一 点 可 以 打造 一 个 生活 服务 的 平台 。 


综 上 所 述 ， 本 地 搜索 将 是 一 个 巨大 的 市 场 ， 这 时 搜索 提供 的 已 经 不 仅仅 是 信息 ， 更 应 该 是 一 种 服 


务 。 正 因 如 此 ，Google Now 登 上 了 历史 舞台 ，Google Now 还 有 什么 功能 ? 


oo 


新 的 应 用 会 更 加 方便 用 户 收取 电子 邮件 ， 当 接收 到 新 邮件 时 ， 它 就 会 自动 弹出 以 便 查看 。 
实现 了 办 理 登 记 手 续 的 QR CODE 终 端的 更 新 ， 但 是 这 一 功能 目前 仅 限于 美国 联合 航空 公司 使 用 。 
具有 新 的 镜头 搜索 功能 ， 令 搜索 和 查找 更 加 方便 准确 。 

具有 步行 和 行车 里 程 记录 功能 ， 这 个 计 步 器 功能 可 通过 Android 设备 的 传感器 来 统计 用 户 每 月 
行驶 的 里 程 ， 包 括 步行 和 骑 自行 车 的 路 程 。 

拥有 并 强化 了 对 博物 馆 、 电 影院 、 餐 厅 等 搜索 帮助 。 

旅游 和 娱乐 特色 功能 : 包括 汽车 租赁 、 演 唱 会 门票 和 通勤 共享 方面 的 卡片 。 公 共 交 通 和 电视 节 
目的 卡片 进行 了 改善 ， 这 些 卡片 现在 可 以 听 音 识别 音乐 和 节目 信息 。 用 户 可 以 为 新 媒体 节目 的 
开播 设 定 搜索 提醒 ， 同 时 还 可 以 接收 实时 NCAA 橄 槛 球 比 分 。 


8.1.2 Google Now 的 用 法 


其 实 Google Now 并 不 是 如 同 Google Mail. Google Talk 那样 的 独立 App, Google Now 被 Google 


集成 到 了 Google 搜索 中 。 在 正常 情况 下 ， 开 启 Google 搜索 即 可 使 用 Google Now。 但 是 因为 Google 


搜索 业务 已 经 退出 中 国 大 陆 ， 所 以 Google 也 没 打算 让 Google Now 覆盖 中 国 大 陆 用 户 。 即 使 顺利 安装 
了 Google 搜索 ， 依 然 找 不 到 Google Now 功能 ， 如 图 8-1 所 示 。 
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语音 


手机 搜索 
隐私 权 和 帐户 
forever seesee@gmail сот 


8-1 默认 没有 Google Now 功能 的 Google 搜索 


此 时 需要 经 过 如 下 所 示 的 步骤 进行 设置 。 
(1) 登录 手机 设备 的 Google 账户 。 
(2) 在 “设置 ”选项 中 将 系统 语言 改 为 英文 ， 如 图 8-2 所 示 。 
(3) 再 次 开启 Google Search 后 会 发 现 出 现 Google Now 了 ， 如 图 8-3 所 示 。 


中 文 (简体 ) 


"X (ИМ) 


English 


Русский 


图 8-2 设置 设备 语言 为 英文 图 8-3 Google Search 中 出 现 Google Now 
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(4) 按照 提示 ， 点 击 Next 按钮 即 可 完成 Google Now 的 初始 化 ， 这 时 候 我 们 就 可 以 使 用 Google 
Now 了 ， 如 图 8-4 所 示 。 


Google Now 
All cards = 
Notifications Ген] 
Му stuff 


My sports teams, stocks, places 


Voice 


Phone search 


accounts 
see(@gmail.com 


图 8-4 此 时 可 以 使 用 Google Now 
(5) 当 设 置 完 Google Now 后 回 到 设置 菜单 ， 将 系统 语言 重新 设置 为 简体 中 文 。 设 置 完毕 后 ， 
Google Now 非但 不 会 被 关闭 , 语言 也 变 成 了 简体 中 文 。 这 意味 着 Google 本 来 就 做 好 了 Google Now 的 
简体 中 文 语言 支持 ， 只 是 没 对 简体 中 文 用 户 开放 而 已 ， 如 图 8-5 Aras. 
LENENENNEECTILET] 


anguage 


х (mt) ® 
PX (ит) 
English м 


即时 贴 会 在 您 需要 时 在 
Русский 这 里 显示 


B 
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(6) 经 过 测试 后 会 发 现 ， 虽 然 Google Now 没有 针对 国内 用 户 开放 ， 但 是 数据 依然 涵盖 了 国内 。 
在 使 用 期 间 ， 公 交 班 次 、 天 气 等 信息 都 准确 无 误 ， 连 接 也 没 遇 到 什么 阻碍 ， 如 图 8-6 所 示 。 


1 E 19 19 您 是 否 想 了 解 到 此 地 点 所 要 花 
费 的 行程 时 间 ? 


图 8-6 使 用 Google Now 的 界面 


М яе 


注意 : 只 有 在 设备 中 登录 并 绑 定 Google 账 号 后 才能 使 用 Google Now 功 能 ， 国 产 行货 手机 没有 内 置 添加 
Google 账 号 功能 ， 读 者 需要 在 获取 Root 权限 后 进行 添加 设置 。 
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2014 年 3 月 ， 继 谷歌 眼镜 之 后 ， 谷 歌 推出 了 Android Wear 可 穿戴 平台 ， 正 式 进 军 智能 手表 领域 。 
与 之 前 传闻 不 同 的 是 ， 谷 歌 并 未 推出 硬件 ， 这 意味 着 什么 ?显然 ， 作 为 一 个 平台 服务 商 ， 谷 歌 的 目标 
不 仅仅 是 一 款 卖 得 好 的 智能 手表 ， 而 是 一 统 整个 穿戴 式 计算 机 行业 。 对 于 用 户 而 言 ，Android Wear 将 
改变 目前 智能 手表 领域 缺乏 标准 、 各 自 为 营 的 混乱 状况 ， 同 时 也 能 够 与 自己 的 Android 手机 获得 更 无 
颖 化 的 数据 共享 。 在 本 节 的 内 容 中 , 将 简单 看 一 看 Android Wear 平台 给 我 们 带 来 了 怎样 的 前 景 和 未 来 。 


8.21 什么 是 Android Wear 


可 以 将 Android Wear 看 作 是 一 个 针对 智能 手表 等 可 穿戴 设备 优化 的 Android 版 本 ，Android Wear 
界面 更 适合 小 屏幕 ， 主 要 功能 是 面向 手机 与 手表 互联 带 来 的 新 型 移动 体验 。 举 例子 来 说 ， 平 常 乘坐 公 
交 车 时 难免 会 遇 到 坐 过 站 的 情况 ， 只 要 你 在 Android Wear 手表 中 设 定好 目的 地 ，GPS 便 会 开始 定位 ， 
及 时 提醒 我 们 拟 到 达 的 车 站 ， 这 样 就 能 够 避免 发 生 坐 过 站 的 情况 。 
从 本 章 前 面 讲解 的 内 容 可 知 ，Google Now 应 用 一 直 致力 于 通过 上 下 文联 想 技术 提供 全 面 、 智 能 的 
搜索 体验 , 现在 Google Now 被 集成 到 Android Wear 中 了 ,不 需要 任何 按键 ， 只 需 说 OK. Google 以 及 
你 想 知道 的 内 容 或 是 进行 的 操作 即 可 。 
谷歌 在 视频 中 演示 了 相当 丰富 的 使 用 场景 ， 比 如 你 要 去 海滩 冲浪 ，Android Wear 手表 会 自动 弹出 
“海里 有 海 下 ”的 警告 ， 在 收 到 短信 场景 时 ， 可 以 直接 语音 回复 即 可 ; 在 登 机 场景 中 ， 直 接 出 示 手 表 
中 的 机 票 二 维 码 就 可 以 完成 登 机 工作 。 
另外 , 健身 应 用 也 是 Android Wear 必 备 的 一 个 功能 。Android Wear 能 够 实时 监测 我 们 的 活动 状态 ， 
记录 步 数 及 热量 消耗 。 当 然 ， 健 身 功能 实际 上 还 有 很 大 的 发 展 空间 ， 相 信众 歌 和 手表 制造 商会 在 日 后 
为 用 户 提供 更 多 样 化 的 健康 监测 形式 ， 如 手表 背面 内 置 传感器 监测 用 户 体温 和 心率 等 。 
由 此 可 见 , Android Wear 是 将 Android 延伸 到 可 穿戴 设备 的 项 目 。 这 个 项 目 首先 从 智能 手表 开始 。 
通过 一 系列 的 新 设备 和 应 用 ，Android Wear 将 能 够 做 到 : 
О 在 你 最 需要 的 时 候 给 出 有 用 的 信息 : 从 你 最 喜欢 的 社交 应 用 中 获取 更 新 ， 使 用 通信 应 用 交流 ， 
从 购物 应 用 、 新 闻 应 用 那里 获取 通知 等 。 

О 直接 回答 你 的 问题 : 说 一 声 OK Google 来 提出 问题 ， 比 如 鲍 梨 里 有 多 少 卡路里 ， 航 班 离开 的 时 
间 ， 游 戏 的 分 数 ， 或 者 完成 某 件 事情 ， 比 如 呼叫 出 租车 、 发 短信 、 预 订餐 厅 或 者 设置 闹钟 。 

口 更 好 地 监控 你 的 健康 : 通过 Android Wear 上 的 提醒 和 健康 信息 ， 达 到 自己 健身 的 目标 。 你 最 爱 
的 健身 应 用 能 够 提供 实时 的 速度 、 距 离 和 时 间 信 息 。 

О 通 向 多 屏 世界 的 钥匙 : Android Wear 能 让 你 控制 其 他 设备 。 用 OK Google 打 开 手 机 上 的 音乐 列 
表 ， 或 者 将 最 喜欢 的 电影 投射 到 电视 上 面 。 在 开发 者 的 参与 下 ， 还 会 有 更 多 的 可 能 性 。 

目前 ， 摩 托 罗 拉 和 LG 已 经 展示 了 概念 的 Android Wear 手表 ， 预 计 三 星 、HTC、 华 硕 等 厂商 都 会 


e 
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后 续 跟 进 。 首 先 来 看 看 摩托 罗拉 的 Moto 360 手表 ， 它 拥有 一 个 接近 传统 手表 的 


ЕШ 


形 金属 表盘 ， 适 合 在 


所 有 场合 佩戴 。 摩 托 罗拉 公司 也 承诺 将 使 用 精良 的 材质 ， 保 持 佩 戴 的 舒适 性 ， 如 图 8-7 Bras. 


图 8-7 Android Wear 手表 


8.22 搭建 Android Wear 开发 环境 


现在 谷歌 已 经 公开 了 Android Wear 的 预览 版 ， 只 面向 谷歌 账号 
http://developer.android.com/wear/index.html， 如 图 8-8 所 示 。 


发 者 用 户 公开 。 具 体 信息 请 登录 


8-8 Android Wear 官方 站 点 


单 击 图 8-8 的 Get Developer Preview 按钮 后 来 到 Android Wear 
开发 环境 的 方法 和 开发 资料 ， 如 图 8-9 所 示 。 


Get Started Get Started with the Developer Preview 


UlOveview 
The Android Wear Developer Preview 
includes tools and АРВ that allow you to 
enhance your app notifications to provide an 
optimized user experience on Android 
wearables. 


Design Principles 


Creating Notifications for 
Android Wear 


Receiving Voice Input froma 


With the Android Wear Developer Preview, 
Notification 


youean 

Adding Pages to a Notification — `, Run the Android Wear platform in the 
Android emulator 

Stacking Notifications 


* Connect your Android device to the 


emulator and view notifications from the 
device as cards on Android Wear 


Notification Reference 


License Agreement 


To get access to the Developer Preview 
tools, click the sign up button on the right, 
then follow the setup instructions below. 


发 者 预览 界面 ， 在 此 列 出 了 搭建 


Signing up provides you access to: 
* New notification APIs in the preview support library 
* Sample apps using the new notification APIs. 


* The Android Wear Preview app for your mobile device, which 
connects your device to the Android Wear emulator. 


8-9 Android Wear 开发 者 预览 界面 
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Andros IER RE 


Android Wear 开发 环境 和 Android 应 用 开发 环境 类 似 ， 有 具体 过 程 如 下 所 示 。 


所 示 。 


Receiving Voice Input froma 


License Agreement 


| Amphitneatre Parkway, Mountain View, CA 94043, United States. 


(1) 根据 本 书 第 2 章 的 内 容 安装 Android SDK, {Е Android SDK 中 包括 了 Android Wear 的 所 有 开 
发 工具 。 
(2) 单 击 图 8-9 中 的 按钮 来 到 注册 界面 ， 在 此 界面 注册 为 Android Wear 预览 开发 者 ， 如 图 8-10 


n 


Important: Your етай address is used to provide your Google account access to the Android Wear Preview 


app Beta Preview on Google Play Store. As such, the email address you provide below must be for the 


account you use to download apps on Google Play Store. We may also use your email address to provide you 


Design Principles with updates about the Android Wear platform release. 


Notifications for 
Android Wear 


E 
What is your Gmail or Google account email address? * 


‘Adding Pages to a Notification 


What is your name? (Optional) 


Stacking Notifications 


Notification Reference Y What is your company name? (Optional) 


! you've published any apps to the Google Play Store, please provide package name(s) (Optional) 
e.g com googe test 


1 have read and agree to the Terms and Conditions. * 
C Yes, lagree 


TAi бооў» жен 


8-10 注册 界面 


Android Wear Developer Preview - Sign Up Confirmation AN х * 
noreply@google.com 2198 + 
发 送 至 我 
Z Z+ > ye ВЕШ 对 英文 人 用 
Hello Developer, 


Thank you for signing up for the Android Wear Developer Preview 


To begin developing on Android Wear, you'll need the Preview Support library and the Android Wear Preview app 
for your mobile device. Follow these steps 


* Download the Preview Support library and samples. 

* Opt-in to become a tester of the Android Wear Preview app in the Google Play Store. After opt-in, it could 
take up to 24 hours for the Android Wear Preview apo to be accessible to you in Google Play. Make sure 
the opt-in user account is the same user signed in to Google Play. 


Refer to the Android Wear Developer Get Started page for detals Since this is a preview release, please do по! 
publicly distribute apps built with the Preview library. Also note that the APIs are potentially subject to change and 
you will need to modify your apps when they are released out of preview. 


Share your experiences and ask questions by joining the Android Wear Developers Google+ Community. We look 
forward to seeing how your apps take advantage of these new APIs to provide Innovative new user experiences! 


— The Android Wear Team 


图 8-11 谷歌 回复 的 邮件 信息 


通过 邮件 中 的 链接 可 以 下 载 Android Wear 预览 版 的 开发 程序 包 和 演示 实例 ， 
AndroidWearPreview.zip， 解 压缩 后 的 效果 如 图 8-12 所 示 。 


上 :mples 2014/3/18 1:27 文件 夹 

1) LICENSE 2014/3/18 1:27 文件 19 КВ 
[O READIE. 2014/3/18 1:27 Ж 15 
Ш) wearable-previer-support. jar 2014/3/18 1:27 Executable Jar... 3 


8-12 解压 缩 AndroidWearPreview.zip 


(3) 输入 Gmail 账户 信息 后 单 击 “ 提 交 ” 按 钮 ， 等 待 谷歌 发 送 回复 的 邮件 信息 ， 如 图 8-11 所 示 。 


下 载 后 的 压缩 包 是 
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(4) 检查 Android SDK 工具 的 版 本 22.6 或 更 高 ， 如 果 当 前 Android SDK 工具 的 版 本 低 于 22.6, 
则 必须 进行 更 新 。 

(5) 在 图 8-13 所 示 的 界面 中 创建 一 个 Android 模拟 器 ，Android Wear 要 求 的 最 低 版 本 是 Android 
4.4.2， 选 择 “armeabi-v7a” 类 型 。 


List of existing Andro tual Devices Located at C:\Users\apple\, android\avd 


AVD Wane Torget Nane Pie. Гат [cras ГЛ 
V Mdroid 4.0 40 1 ABM (аве) 


Details... 


Start 


Refresh 


of А valid Android Virtual Device. A repairable Android Virtual Device. 
X An Android Virtual Device that failed to load Click ‘Detail to see the error. 


8-13. ”准备 创建 一 个 Android 模拟 器 

(6) 单 击 图 8-13 中 的 Мез 按钮 ， 在 新 界面 中 进行 如 下 设置 。 
口 name: 设置 创建 模拟 器 的 名 字 为 wear。 
Q Target: 设置 此 值 最 低 为 Android 4.4.2 - API Level 19. 
O CPU/ABI: 设置 此 值 为 Android Wear ARM (armeabi-v7a) 。 
О Skin: 用 于 设置 Android Wear 的 外 观 ， 现 在 Android Wear 只 有 两 种 外 观 ， 分 别 是 方形 

AndroidWearSquare 或 圆 形 AndroidWearRound。 

оО 其 他 选项 : 设置 为 默认 值 即 可 。 
设置 后 的 界面 效果 如 图 8-14 所 示 。 


се (AVD) 
AD Мале; Few 
Devices! Ë T QWA 240 x 320 11) z 
Target) [Android 4.4.2 - MI Level 19 si 
сум. [Android Wear ARM (armeabi~y7a) a 
Keyboard Г. Mardvare keyboard present 
Skin: 
Front Canara! fione 可 
Back Camera: Bone r| 
nex Duties юн [512 Уй Heap: [6 
Internal Storage! ро pa 可 
SD Ced: r 一 一 一 一 一 一 — 
€ Sim: [ fni 可 
Cru: [MM sense 
Enulation Options: | [ Snapshot Г Use Host GPU 


F override the exi 


ting ATD with the ture rune 


a | 
图 814 创建 了 一 个 方形 Android Wear 模拟 器 


Android 外 设 开发 实战 


单 击 OK 按钮 完成 创建 ， 单 击 Start 按钮 可 以 运行 这 个 模拟 器 ,运行 后 的 
效果 如 图 8-15 所 示 。 

另外 ， 通 过 谷歌 回复 的 Gmail 邮件 可 知 ， 可 以 登录 https://play.google.com/ 
apps/testing/com.google. android.wearablepreview.app Ж Android Wear Preview, ` 
然 最 简单 的 方法 是 从 Paly 商店 下 载 获取 ， 如 图 8-16 所 示 。 

另外 , 也 可 以 登录 https;/plus.google.com/communities/11338122747302 1565406 "= 
进入 测试 人 员 社 区 ， 在 这 里 可 以 和 一 线 开发 人 员 进 行 交流 ， 如 图 8-17 所 示 。 图 8-15 模拟 器 运行 效果 


网 
p Google play + ES 


Voice actions disabled in this preview 


Android Wear Preview 


我 的 应 用 = 
BETA 
ia Аземин 
н Xxx n 3^1 | Google 
我 的 Play 动态 
我 的 心 原单 


图 8-16 从 Paly 商店 下 载 获取 Android Wear Preview 


Google+ $ Га | :shauiag Hg? 
Qua mus жана 


Android Wear 要 发 表 信 息 或 评论 ， 请 加 入 读 社 群 maur 


Developers 


社 群 简介 
Louis my эз unity for Android Wear 
| јен. Android Wear extends the 
Android platform to wearables, providing а common 
icd Wear нойон Ap Updated fer NT, Tb user experience and consistent developer platform. 


Support see what youll build for this new 


Last week, we promised we were in the process of 


апэзо!эо wear 


vu) [2 UE 
公开 5.824 个 成 员 


вае v ө Атой Gupta 
Ы) Ф Raajesh Sundaram 


图 8-17 Android Wear 开发 者 交流 社区 
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83 ЖЖ Android Wear 程序 


知识 点 讲解 ， 光 盘 :视频 \ 知 识 点 \ 第 8 章 \ 开 发 Android Wear 程序 .avi 
在 搭建 完 Android Wear 开发 环境 之 后 ， 接 下 来 开始 讲解 开发 Android Wear 程序 的 基本 知识 。 在 本 
节 将 首先 讲解 开发 Android Wear 程序 的 知识 ， 然 后 通过 一 个 演示 实例 来 讲解 具体 开发 过 程 。 


8.3.1 创建 通知 


当 一 个 手机 或 平板 电脑 等 Android 设备 连接 到 一 个 Android Wear 时 ， 所 有 的 通知 在 设备 之 间 都 是 
共享 的 。 在 Android Wear 中 ， 每 个 通知 都 会 以 新 卡片 背景 流 的 样式 出 现 ， 如 图 8-18 所 示 。 


图 8-18 出 现 通知 


由 此 可 见 ， 无 须 经 过 多 少 工作 量 ， 便 可 以 在 Android Wear 设备 中 创建 一 个 通知 应 用 程序 用 。 但 是 
为 了 提高 用 户 体验 ， 当 用 户 面 对 一 个 通知 时 ， 再 通过 声音 来 回复 。 
(1) 引入 需要 的 类 
EFR Android Wear 应 用 程序 之 前 ， 必 须 首先 详细 阅读 开发 者 预览 文档 。 在 该 文档 文件 中 提 到 ， 
Android Wear 应 用 程序 必须 包括 V4 支持 库 和 开发 者 预览 版 支持 库 。 所 以 开始 的 时 候 , 应 该 在 你 的 项 目 
代码 中 包括 下 面 的 引入 文件 : 
import android.preview.support.wearable.notifications.*; 


import android.preview.support.v4. app. NotificationManagerCompat; 
import android.support.v4.app. NotificationCompat; 
(2) 通过 提醒 Builder 创建 通知 

在 Android Wear 中 ， 通 过 用 V4 支持 库 可 以 实现 最 新 的 通知 等 功能 ， 例 如 用 操作 按钮 和 大 图 标 创 
建 通知 。 例 如 在 下 面 的 演示 代码 中 ， 使 用 NotificationCompat API 结合 新 的 NotificationManagerCompat 
API 可 以 创建 并 发 布 通知 。 

int notificationld = 001; 

II Build intent for notification content 

Intent viewIntent = new Intent(this, ViewEventActivity.class); 

viewIntent.putExtra(EXTRA EVENT ID, eventld); 

PendingIntent viewPendinglntent = 

PendingIntent.getActivity(this, 0, viewIntent, 0); 


NotificationCompat. Builder notificationBuilder = 


. _ 
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new NotificationCompat.Builder(this) 
.setSmalllcon(R.drawable.ic event) 
.setContentTitle(eventTitle) 
.setContentText(eventLocation) 
-setContentIntent(viewPendinglntent); 


II Get an instance of the NotificationManager service 
NotificationManagerCompat notificationManager = 
NotificationManagerCompat.from(this); 


11 Build the notification and issues it with notification manager. 
notificationManager.notify(notificationld, notificationBuilder. build()); 
通过 上 述 代码 ， 当 上 述 通知 出 现在 手持 设备 中 时 ， 用 户 可 以 调用 指定 的 setcontentintent() 方 法 通过 
触摸 的 方式 通知 PendingIntent。 当 这 个 通知 出 现在 Android Wear 中 时 ， 用 户 也 可 以 用 通知 操作 来 调用 
在 手持 设备 上 的 意图 。 
(3) 添加 动作 按钮 
除了 通过 setcontentintent() 定 义 的 主要 操作 外 ， 还 可 以 通过 传递 PendingIntent 到 addaction() 方 法 的 
方式 添加 其 他 操作 。 例 如 下 面 的 代码 显示 了 和 前 面 类 型 相同 的 通知 ， 但 是 增加 了 一 个 在 地 图 上 实现 定 
位 的 事件 操作 。 
// Build an intent for an action to view a map 
Intent mapintent = new Intent(Intent.ACTION VIEW); 
Uri geoUri = Uri.parse("geo:0,0?q-" + Uri.encode(location)); 
mapintent.setData(geoUri); 
PendingIntent mapPendingintent = 
PendingIntent.getActivity(this, 0, maplntent, 0); 


NotificationCompat. Builder notificationBuilder = 

new NotificationCompat.Builder(this) 

.setSmalllcon(R.drawable.ic_event) 

.setContentTitle(eventTitle) 

.setContentText(eventLocation) 

.setContentIntent(viewPendinglntent) 

.addAction(R.drawable.ic map, 

getString(R.string.map), mapPendinglntent); 

(4) 为 通知 添加 一 个 大 视图 
在 手持 设备 上 ， 用 户 可 以 通过 扩大 通知 卡片 的 方式 来 查看 通知 内 容 。 在 Android Wear 设备 中 ， 大 
视图 的 内 容 是 默认 可 见 的 。 当 在 通知 中 添加 扩展 的 内 容 后 , 可 以 调用 NotificationCompat.Builder 对 象 中 
的 setStyle() 方 法 实现 bigtextstyle 或 inboxstyle 样式 实例 。 


例如 在 下 面 的 代码 中 ,添加 了 NotificationCompat.bigtextstyle 实例 的 事件 通知 ， 这 样 可 以 包括 完整 
的 事件 描述 ， 包 括 可 以 提供 比 setcontenttext0) 空 间 更 多 的 文本 内 容 。 


BigTextStyle bigStyle = new NotificationCompat.BigTextStyle(); 
bigStyle.bigText(eventDescription); 


NotificationCompat.Builder notificationBuilder = 
new NotificationCompat.Builder(this) 
.setSmalliIcon(R.drawable.ic event) 
-setLargelcon(BitmapFractory.decodeResource( 


(m, 
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getResources(), R.drawable.notif_background)) 
.setContentTitle(eventTitle) 
.setContentText(eventLocation) 
.setContentIntent(viewPendinglntent) 
-addAction(R.drawable.ic map, 

getString(R.string.map), mapPendinglntent) 
.setStyle(bigStyle); 


注意 : 可 以 使 用 setlargeicon() 方 法 为 任何 通知 添加 一 个 背景 图 像 。 


(5) 为 设备 添加 新 的 功能 
在 Android Wear 预览 版 的 支持 库 中 提供 了 很 多 新 的 API， 通 过 这 些 API 可 以 在 穿戴 设备 中 提高 
知 用 户 体验 。 例 如 可 以 添加 额外 的 页 面 的 内 容 ， 或 添加 用 户 使 用 语音 输入 文本 的 响应 功能 。 通 过 使 用 
这 些 新 的 API， 通 过 实例 的 NotificationCompat.Builder() 构 造 函 数 可 以 添加 新 的 功能 。 例 如 下 面 的 演示 
代码 。 
/ Create а NotificationCompat.Builder for standard notification features 
NotificationCompat. Builder notificationBuilder = 
new NotificationCompat.Builder(mContext) 
.setContentTitle("New mail from " + sender.toString()) 
.setContentText(subject) 
.SetSmalllcon(R.drawable.new_mail); 


11 Create a WearablesNotification.Builder to add special functionality for wearables 
Notification notification = 
new WearableNotifications.Builder(notificationBuilder) 
.setHintHidelcon(true) 
-build(); 
在 上 述 代 码 中 ， 方 法 setHintHideIcon() 的 功能 是 从 通知 卡 中 移 除 应 用 程序 图 标 。 方 法 setHintHidelcon() 
是 一 个 新 的 通知 功能 ， 可 以 从 WearableNotifications.Builder 对 象 中 生成 。 
当 想 要 推送 传递 你 的 通知 时 ， 一 定 要 始终 使 用 NotificationManagerCompat API， 例 如 下 面 的 演示 代码 。 
NotificationManagerCompat notificationManager = 
NotificationManagerCompat.from(this); 


11 Build the notification and issues it with notification manager. 
notificationManager.notify(notificationld, notification); 


注意 : 在 笔者 写作 此 书 时 ，Android Wear 开 发 者 预览 版 API 只 是 为 了 开发 和 测试 而 推出 的 ， 并 不 是 为 了 
编写 出 具体 的 应 用 程序 。 谷 歌 在 正式 公布 Android Wear SDK 之 前 ， 上 述 开 发 流程 只 是 待定 的 。 


8.3.2 创建 声音 


如 果 在 创建 的 通知 中 包含 了 文本 回复 功能 ， 例 如 回复 一 封 邮件 ， 在 通常 情况 下 会 在 手持 设备 上 启 
动 一 个 Activity。 当 我 们 的 通知 显示 在 穿戴 设备 上 时 ， 可 以 允许 用 户 使 用 语音 输入 口 诉 一 个 回复 ， 还 可 
以 提供 预先 设置 的 文本 信息 让 用 户 选择 。 当 用 户 使 用 语音 回复 或 者 选择 预 设 信息 时 ， 系 统 会 发 送信 息 
到 与 手持 设备 相连 的 应 用 ， 该 信息 以 一 个 附加 品 的 形式 与 我 们 定义 使 用 的 通知 行动 的 Intent 相关 联 ， 
如 图 8-19 所 示 。 


ЕТТЕ 


A819 声音 回复 


注意 : 在 安 卓 模 拟 器 上 开发 时 ， 即 使 在 语音 输入 域 ， 也 必须 要 使 用 文本 回复 ， 所 以 需 确保 在 AVD 设 置 
上 已 激活 了 Hardware keyboard present。 


C1) 定义 远程 回复 
在 Android Wear 中 创建 支持 语音 输入 的 行动 时 ， 首 先 需 要 使 用 RemoteInput.Builder APIs 创建 一 个 
RemoteInput 的 实例 。 RemoteInput.Builder 构造 器 获取 一 个 String 类 型 的 值 ， 系 统 会 将 这 个 值 作为 一 个 
key 传递 给 Intent extra， 这 个 Intent 可 以 将 回复 信息 传送 到 手持 设备 中 的 应 用 程序 。 例 如 在 下 面 的 代码 
中 创建 了 一 个 新 的 RemoteInput 对 象 ， 功 能 是 提供 自 定 义 标签 给 语音 输入 命令 。 
Il 传送 给 行动 intent 的 key 的 字符 串 
private static final Sting EXTRA VOICE REPLY = "extra voice reply"; 
String replyLabel = getResources().getString(R.string.reply label); 
Remotelnput remotelnput = new Remotelnput.Builder(EXTRA VOICE REPLY) 
.setLabel(replyLabel) 
-build(); 
(2) 添加 预 置 文本 进行 回复 
除了 支持 语音 输入 外 ， 在 Android Wear 中 还 可 以 提供 最 多 5 条 预 置 文本 回复 信息 以 供用 户 进行 快 
速 回复 。 实 现 方法 是 调用 setChoices() 方 法 ， 并 将 字符 串 数 组 传递 给 它 。 例 如 可 以 在 资源 数组 中 定义 如 
下 所 示 的 回复 。 
res/values/strings.xml 
<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<string-array name="reply_choices"> 
<item>Yes</item> 
<item>No</item> 
<item>Maybe</item> 
</string-array> 
</resources> 


效果 如 图 8-20 所 示 。 


图 8-20 添加 的 回复 数值 
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然后 通过 如 下 代码 释放 String 数组 并 将 其 添加 到 Remotelnput 中 。 
String replyLabel = getResources().getString(R.string.reply_label); 
String[ ] replyChoices = getResources().getStringArray(R.array.reply choices); 


Remotelnput remotelnput = new Remotelnput.Builder(EXTRA_VOICE_REPLY) 
-setLabel(replyLabel) 
.setChoices(replyChoices) 
.build(); 
(3) 为 主 行动 接收 语音 输入 
在 Android Wear 应 用 中 ， 如 果 Reply 是 我 们 应 用 程序 的 主 行动 (由 setContentIntent() 方法 定义 ) , 
那么 需要 使 用 addRemoteInputForContentIntent() 方 法 将 RemoteInput 添加 到 主 行动 上 。 例 如 下 面 的 演 
示 代 码 。 
11 为 回复 行动 创建 intent 
Intent replyIntent = new Intent(this, ReplyActivity.class); 
PendingIntent replyPendinglntent = 
PendingIntent.getActivity(this, 0, replyIntent, 0); 
11 创建 通知 
NotificationCompat.Builder replyNotificationBuilder = 
new NotificationCompat.Builder(this) 
.SetSmalllcon(R.drawable.ic_new_message) 
.setContentTitle("Message from Travis") 
.setContentText("I love key lime pie!") 
.setContentintent(replyPendingIntent); 
// 创 建 运程 回复 < 语音 > 
Remotelnput remotelnput = new Remotelnput.Builder(EXTRA_VOICE_REPLY) 
.setLabel(replyLabel) 
-build(); 
// 创 建 穿戴 设备 的 通知 并 添加 语音 输入 
Notification replyNotification = 
new WearableNotifications.Builder(replyNotificationBuilder) 
.addRemotelnputForContentIntent(remoteInput) 
-build(); 
通过 使 用 addRemoteInputForContentIntent() 方 法 ， 将 Remotelnput 对 象 添加 到 通知 的 主 行动 中 后 ， 
通常 Open 按钮 会 显示 为 Reply 按钮 ， 当 用 户 在 Android Wear 上 选择 它 时 ， 就 会 启动 语音 输入 UI 视图 
界面 。 
(4) 为 次 行动 设置 语音 输入 
如 果 Reply 动作 不 是 我 们 创建 通知 的 主动 作 , 而 只 是 为 次 行动 激活 语音 输入 ,那么 可 以 添加 Remote- 
Input 到 新 的 行动 按钮 (由 Action 对 象 定义 )。 通 过 Action.Builder0 构 造 器 实例 化 Action， 它 会 给 行动 
按钮 添加 一 个 icon 和 文本 标签 ， 加 上 PendingIntent， 当 用 户 选择 这 个 行动 时 ， 系 统 会 使 用 它 调 用 我 们 


的 应 用 。 例 如 下 面 的 演示 代码 。 
II 创建 一 个 pending intent， 当 用 户 选择 这 个 行动 时 ， 会 启用 这 个 intent 
Intent replyIntent = new Intent(this, ReplyActivity.class); 
PendingIntent pendingReplyIntent = 
PendingIntent.getActivity(this, 0, replyIntent, 0); 


/| 创建 远程 输入 Create the remote input 
Remotelnput remotelnput = new Remotelnput.Builder(EXTRA_VOICE_REPLY) 
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.SetLabel(replyLabel) 
-build(); 


/创建 通知 行动 Create the notification action 
Action replyAction = new Action.Builder(R.drawable.ic_message, 
"Reply", pendinglIntent) 
.addRemotelnput(remotelnput) 
-build(); 
然后 为 Action 添加 Remotelnput.Builder, 使 用 addAction()7714:73 WearableNotifications.Builder 添加 
Action。 例 如 下 面 的 演示 代码 。 
// 创 建 基本 的 通知 创建 者 Create basic notification builder 
NotificationCompat.Builder replyNotificationBuilder = 
new NotificationCompat.Builder(this) 
.SetContentTitle("New message"); 


J| 创建 通知 行动 并 添加 远程 输入 Create the notification action and add remote input 
Action replyAction = new Action.Builder(R.drawable.ic_message, 

"Reply", pendinglIntent) 

.addRemotelnput(remoteInput) 

-build(); 


П 创建 穿戴 设备 的 通知 并 添加 行动 Create wearable notification and add action 
Notification replyNotification = 
new WearableNotifications.Builder(replyNotificationBuilder) 
.addAction(replyAction) 
.build(); 
现在 ， 当 用 户 在 Android Wear 设备 上 选择 Reply 时 ， 系 统 提示 用 户 使 用 语音 输入 〈 如 果 提供 了 预 
置 回复 ， 则 会 显示 预 置 列 表 )。 当 用 户 完 成 回复 时 ， 系 统 会 调用 与 该 行动 关联 的 intent， 并 添加 作为 字 
符 值 的 EXTRA VOICE REPLY extra (传递 给 RemoteInput.Builder 构造 器 的 字符 串 ) 到 用 户 信息 。 


8.3.3 ”给 通知 添加 页 面 


当 想 为 Android Wear 设备 提供 更 多 的 信息 , 而 且 不 需要 用 户 使 用 手持 设备 打开 应 用 时 , 可 以 在 Android 
Wear 上 为 通知 添加 一 个 或 若干 页 面 , 附加 的 页 面 会 在 主 通知 卡片 的 右边 立即 显示 出 来 , 如 图 8-21 所 示 。 


10 mins 


Picnic with Rachel Bring some french 
bread, good cheese, 


and a bottle of red 


图 8-21 给 通知 添加 页 面 


当 创建 多 张 页 面 时 ， 第 一 步 需 要 把 通知 显示 在 手机 或 平板 设备 ， 也 就 是 先 创 建 一 个 主 通知 〈 第 一 
张 页 面 ), 然后 使 用 addPage() 方 法 每 次 添加 一 张 页 面 , 或 者 使 用 addPages() 方 法 从 Collection 对象 添 加 


@ 


若干 页 面 。 例 如 下 面 的 演示 代码 。 

/为 主 通知 创建 Builder 

NotificationCompat.Builder notificationBuilder = 
new NotificationCompat.Builder(this) 
.setSmalllcon(R.drawable.new_message) 
.setContentTitle("Page 1") 
.setContentText("Short message") 
.setContentIntent(viewPendinglntent); 


/为 第 二 张 页 面 创建 big text 风格 
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BigTextStyle secondPageStyle = new NotificationCompat.BigTextStyle(); 


secondPageStyle.setBigContentTitle("Page 2") 
-bigText("A lot of text..."); 


11 Create second page notification 

Notification secondPageNotification = 
new NotificationCompat.Builder(this) 
.setStyle(secondPageStyle) 
-build(); 

11 Create main notification and add the second page 

Notification twoPageNotification = 
new WearableNotifications.Builder(notificationBuilder) 
.addPage(secondPageNotification) 
-build(); 

8.3.4 通知 堆 


当 为 手持 设备 创建 通知 时 ， 大 家 可 能 习惯 于 把 同类 型 的 通知 放 在 一 个 汇总 通知 里 。 例 如 ， 如 果 你 


的 应 用 创建 了 接收 信息 的 通知 ， 当 接收 到 多 条 信息 时 不 会 显示 多 条 通知 在 手持 设备 上 ， 而 是 使 用 单条 
通知 。 此 时 只 需要 提供 汇总 信息 就 可 以 了 ， 例 如 “两 条 新 信息 ”的 提示 。 但 是 在 Android Wear 设备 上 ， 
汇总 信息 没什么 作用 ， 因 为 用 户 无 法 在 Android Wear 设备 上 逐条 阅读 细节 〈 因 为 他 们 必须 在 手持 设备 
上 打开 应 用 查看 更 多 信息 )。 为 了 Android Wear 设备 ,需要 把 所 有 的 通知 聚集 到 一 个 堆 里 。 通 知 堆 以 单 
张 卡片 的 形式 存在 ,用 户 可 以 展开 它 逐 条 查看 ， 新 的 setGroup() 方 法 为 你 提供 了 可 能 ， 虽 然 在 手持 设备 


上 ， 它 仍然 仅 提供 一 条 汇总 信息 ， 如 图 8-22 所 示 。 
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图 8-22 ”通知 堆 演 示 界 面 


(1) 将 通知 逐条 添加 到 Group 


为 了 在 Android Wear 中 创建 堆 ， 需 要 为 每 条 通知 调用 setGroup() 方 法 ， 并 将 唯一 的 group key 传递 


Ò 
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给 它们 。 例 如 下 面 的 演示 代码 。 
final static String GROUP_KEY_EMAILS = "group_key_emails"; 


NotificationCompat. Builder builder = new NotificationCompat.Builder(mContext) 
.setContentTitle("New mail from " + sender) 
.setContentText(subject) 
.setSmalliIcon(R.drawable.new mail); 


Notification notif = new WearableNotifications.Builder(builder) 
.setGroup(GROUP KEY EMAILS) 
-build(); 


在 默认 情况 下 ， 会 以 我 们 的 添加 顺序 来 展现 通知 ， 最 新 的 通知 显示 在 头 部 。 但 是 也 可 以 通过 传递 
一 个 位 置 值 给 setGroup() 的 第 二 个 参数 ， 在 group 里 定义 一 个 特殊 的 位 置 。 
(2) 添加 一 个 汇总 通知 
在 Android Wear 应 用 中 ， 提 供 一 个 汇总 通知 给 手持 设备 是 很 重要 的 。 除 了 逐条 添加 通知 到 同一 个 
通知 堆 外 ， 建 议 仍 添 加 一 个 汇总 通知 ， 不 过 设置 它 的 次 序 为 GROUP ORDER_SUMMARY。 例 如 下 面 
的 演示 代码 。 
Notification summaryNotification = new WearableNotifications. Builder(builder) 


.SetGroup(GROUP. KEY. EMAILS, WearableNotifications.GROUP_ORDER_SUMMARY) 
.build(); 


这 条 通知 不 会 显示 在 Android Wear 设备 上 的 通知 堆 里 ， 只 会 显示 在 手持 设备 上 的 唯一 通知 上 。 
8.3.5 ”通知 语法 介绍 


(1) android.preview.support.v4.app 
用 NotificationCompat.Builder 对 象 来 设 定 通知 的 UI 信息 和 行为 ,调用 NotificationCompat.Builder.build() 
来 创建 通知 ， 调 用 NotificationManager.notify() 来 发 送 通 知 。 
一 条 通知 必须 包含 如 下 信息 : 
О 一 个 小 图 标 : 用 setSmallIcon() 来 设置 。 
О 一 个 标题 : 用 setContentTitle() 来 设置 。 
O 详情 文字 : 用 setContentText() 来 设置 。 
(2) android.preview.support.wearable.notifications 表示 可 穿戴 设备 的 通知 信息 类 型 ， 其 中 不 同 的 输 
入 类 型 信息 如 表 8-1 所 示 。 


表 8-1 通知 信息 类 型 表 


类 m 说 а 
RemoteInput 远程 输入 类 ， 可 穿戴 设备 输入 
Remotelnput.Builder 生成 RemotelInput 的 目标 
WearableNotifications 可 穿戴 设备 类 型 的 通知 
WearableNotifications.Action 可 穿戴 设备 类 型 通知 的 行为 动作 


WearableNotifications.Action.Builder 生成 类 WearableNotifications.Action 对 象 


一 个 NotificationCompat.Builder 生成 器 对 象 ， 为 可 穿戴 的 扩展 功能 提 


WearableNotifications.Builder 
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例如 在 下 面 的 代码 中 ， 通 过 注释 详细 讲解 并 演示 了 各 个 Android Wear 对 象 的 基本 用 法 。 
int notificationld = 001; /通知 id 
Intent replylntent = new Intent(this, ReplyActivity.class); / 响应 Action， 可 以 启动 Activity, Service 或 者 


Broadcast 
Pendinglntent pendinglntent = Pendinglntent.getActivity(this, 0, replyIntent, 0); 
Remotelnput remotelnput = new RemoteInput.Builder("key")/ 响 应 输入 ，key 为 返回 Intent 的 Extra 的 Key 值 
.setLabel("Select") /| 输入 页 标题 
.setChoices(String[]) ”// 输 入 可 选项 
-build(); 
Action replyAction = new Action.Builder(R.drawable, //WearableNotifications.Action.Builder 对 应 可 穿戴 设备 的 


Action Ж 


"Reply", pendingIntent) /对 应 pendinglntent 
.addRemotelnput(remoteInput) 
-build(); 


NotificationCompat.Builder notificationBuilder = new NotificationCompat.Builder(mContext) /标准 通知 创建 
.setContentTitle(title).setContentText(subject).setSmalllcon(R.drawable).setStyle(style) 
.setLargelcon(bitmap) // 设 置 可 穿戴 设备 显示 的 背景 图 
-setContentIntent(pendingIntent) /可 穿戴 设备 左 滑 ， 有 默认 Open 操作 ， 对 应 手机 端的 点 击 通知 
.addAction(R.drawable, String, pendingIntent); /增加 一 个 操作 ， 可 加 多 个 
Notification notification = new WearableNotifications.Builder(notificationBuilder) /创建 可 穿戴 类 通知 ,为 通知 
增加 可 穿戴 设备 新 特性 ， 必 须 与 兼容 包 里 的 NotificationManager 对 应 ， 否 则 无 效 


.setHintHidelcon(true) /隐藏 应 用 图 标 
.addPages(notificationPages) /增加 Notification 页 


.addAction(replyAction) /对 应 上 页 ，pendinglntent 可 操作 项 
.addRemotelnputForContentintent(replyAction) /可 为 Contentlntent 替换 默认 的 Open 操作 
.setGroup(GROUP_KEY, WearableNotifications.GROUP ORDER SUMMARY) /为 通知 分 组 
.setLocalOnly(true) /可 设置 只 在 本 地 显示 
.setMinPriority() // 设 置 只 在 可 穿戴 设备 上 显示 通知 

.build(); 

NotificationManagerCompat notificationManager = NotificationManagerCompat.from(this);// 获 得 Manager 
notificationManager.notify(notificationld, notificationBuilder.build());// 发 送 通知 
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知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 8 章 \ 开 发 一 个 Android Wear 程序 .avi 
在 接 下 来 的 内 容 中 ， 将 通过 一 个 具体 实例 来 讲解 开发 一 个 Android Wear 程序 的 方法 。 


实例 功能 源码 路 径 : 
sa AB ЧИР ТИШИ 开发 一 个 Android Wear FF __; 光盘 :daima27wearmaster — 


本 实例 的 具体 实现 流程 如 下 。 
(1) 编写 布局 文件 activity main.xml， 有 具体 实现 代码 如 下 所 示 。 
<RelativeLayout xmins:android="http://schemas.android.com/apk/res/android" 
xmins:tools-"http://schemas.android.com/tools" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:paddingLeft-"(g)dimen/activity horizontal margin" 
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android:paddingRight="@dimen/activity_horizontal_margin" 
android:paddingTop="@dimen/activity_vertical_margin" 
android:paddingBottom="@dimen/activity_vertical_margin" 
tools:context="com.ezhuk.wear.MainActivity"> 
<TextView 
android:text="@string/hello_world" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" /> 
</RelativeLayout> 
(2) 编写 值 文件 strings.xml， 功 能 是 设置 通知 的 文本 内 容 ， 具 体 实现 代码 如 下 所 示 。 
<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<string name="app_name">Wear</string> 
<string name="hello_world">Test</string> 
<string name="content_title">Basic Notification</string> 
<string name="content_text">Sample text.</string> 
«string name="page'_title">Page 1</string> 
<string name="page1_text">Sample text 1.</string> 
«string name-"page2 title">Page 2</string> 
<string name="page2_text">Sample text 2.</string> 
«string name="action_title">Action Title</string> 
«string name="action_text">Action text.</string> 
<string name="action_button">Action</string> 
«string name="action_label">Action</string> 
«string name-"summary title"> Summary Title</string> 
<string name="summary_text">Summary text.</string> 
<string-array name="input_choices"> 
<item>First item</item> 
<item>Second item</item> 
<item>Third item</item> 
</string-array> 
</resources> 
(3) 编写 文件 MainActivityjava 实现 程序 的 主 Activity， 功 能 是 载 入 Android Wear 的 通知 类 
NotificationUtils， 调 用 不 同 的 showNotificationXX 方法 显示 通知 信息 ， 有 具体 实现 代码 如 下 所 示 。 
package com.ezhuk.wear; 


import android.app.Activity; 
import android.os.Bundle; 


import static com.ezhuk.wear.NotificationUtils.*; 


public class MainActivity extends Activity ( 
@Override 
protected void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.activity main); 
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@Override 
protected void onResume() { 
super.onResume(); 


showNotification(this); 
showNotificationNolcon(this); 
showNotificationMinPriority(this); 
showNotificationBigTextStyle(this); 
showNotificationBigPictureStyle(this); 
showNotificationInboxStyle(this); 
showNotificationWithPages(this); 
showNotificationWithAction(this ); 
showNotificationWithInputForPrimaryAction(this); 
showNotificationWithlnputForSecondaryAction(this); 
showGroupNotifications(this); 

} 


@Override 
protected void onPause() { 
super.onPause(); 

} 

} 
(4) 编写 文件 NotificationUtilsjava， 功 能 是 定义 各 种 不 同类 型 showNotificationXX 的 通知 方法 ， 
具体 实现 代码 如 下 所 示 。 

import android.app.Notification; 
import android.app.PendingIntent; 
import android.content.Context; 
import android.content. Intent; 
import android.graphics.BitmapFactory; 
import android.net.Uri; 
import android.preview.support.v4.app.NotificationManagerCompat; 
import android.preview.support.wearable.notifications. RemotelInput; 
import android.preview.support.wearable.notifications. WearableNotifications; 
import android.support.v4.app.NotificationCompat; 


public class NotificationUtils ( 
private static final String ACTION TEST = "com.ezhuk.wear.ACTION"; 
private static final Sting ACTION EXTRA - "action"; 


private static final String NOTIFICATION GROUP - "notification group"; 


public static void showNotification(Context context) ( 
NotificationCompat.Builder builder = 
new NotificationCompat.Builder(context) 
.setSmalliIcon(R.drawable.ic launcher) 
.setContentTitle(context.getString(R.string.content title)) 
.setContentText(context.getString(R.string.content text)); 


NotificationManagerCompat.from(context).notify(0, 
new WearableNotifications.Builder(builder) 
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-build()); 
} 


public static void showNotificationNolcon(Context context) { 
Notification Compat.Builder builder = 
new NotificationCompat.Builder(context) 
-setSmalllcon(R.drawable.ic_launcher) 
-setContentTitle(context.getString(R.string.content title)) 
.setContentText(context.getString(R.string.content text)); 


NotificationManagerCompat.from(context).notify(1 , 
new WearableNotifications.Builder(builder) 
.setHintHidelcon(true) 
-build()); 
} 


public static void showNotificationMinPriority(Context context) { 
NotificationCompat.Builder builder = 
new NotificationCompat.Builder(context) 
.setSmalllcon(R.drawable.ic launcher) 
.setContentTitle(context.getString(R.string.content title)) 
.setContentText(context.getString(R.string.content text)); 


NotificationManagerCompat.from(context).notify(2, 
new WearableNotifications.Builder(builder) 
.setMinPriority() 
-build()); 
} 


public static void showNotificationWithStyle(Context context, 
int id, 
NotificationCompat.Style style) ( 
Notification notification - new WearableNotifications.Builder( 
new NotificationCompat.Builder(context) 
.setSmalllcon(R.drawable.ic launcher) 
.setStyle(style)) 
-build(); 


NotificationManagerCompat.from(context).notify(id, notification); 
} 


public static void showNotificationBig TextStyle(Context context) { 
showNotificationWithStyle(context, 3, 
new NotificationCompat.BigTextStyle() 
.setSummaryText(context.getString(R.string.summary text)) 
.setBigContentTitle("Big Text Style") 
-bigText("Sample big text.")); 
} 


public static void showNotificationBigPictureStyle(Context context) { 
showNotificationWithStyle(context, 4, 
new NotificationCompat.BigPictureStyle() 
.setSummaryText(context.getString(R.string.summary text)) 
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-setBigContentTitle("Big Picture Style") 
-bigPicture(BitmapFactory.decodeResource( 
context.getResources(), R.drawable.background))); 
} 


public static void showNotificationInboxStyle(Context context) { 
showNotificationWithStyle(context, 5, 
new NotificationCompat.InboxStyle() 
.setSummaryText(context.getString(R.string.summary. text)) 
.setBigContentTitle("Inbox Style") 
.addLine("Line 1") 
.addLine("Line 2")); 
} 


public static void showNotificationWithPages(Context context) { 
NotificationCompat.Builder builder = 
new NotificationCompat.Builder(context) 
-setSmalllcon(R.drawable.ic_launcher) 
.setContentTitle(context.getString(R.string.page1 title)) 
.setContentText(context.getString(R.string.page1 text)); 


Notification second 7 new NotificationCompat.Builder(context) 
.setSmalliIcon(R.drawable.ic launcher) 
.setContentTitle(context.getString(R.string.page2 title)) 
.setContentText(context.getString(R.string.page2 text) 
-build(); 


NotificationManagerCompat.from(context).notify(6, 
new WearableNotifications.Builder(builder) 
.addPage(second) 
-build()); 
} 


public static void showNotificationWithAction(Context context) { 
Intent intent = new Intent(Intent.ACTION VIEW); 
intent.setData(Uri.parse("")); 
PendingIntent pendingIntent = 
PendingIntent.getActivity(context, 0, intent, 0); 


NotificationCompat.Builder builder = 
new NotificationCompat.Builder(context) 

.setSmalliIcon(R.drawable.ic launcher) 

.setContentTitle(context.getString(R.string.action title)) 

.setContentText(context.getString(R.string.action text) 

.addAction(R.drawable.ic launcher, 
context.getString(R.string.action button), 
pendingIntent); 


NotificationManagerCompat.from(context).notify(7, 


new WearableNotifications.Builder(builder) 
-build()); 
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public static void showNotificationWithInputForPrimaryAction(Context context) { 
Intent intent = new Intent(ACTION_TEST); 
PendingIntent pendingIntent = 
Pendingintent.getActivity(context, 0, intent, 0); 


Notification Compat.Builder builder = 
new NotificationCompat.Builder(context) 
.setSmalllcon(R.drawable.ic launcher) 
.setContentTitle(context.getString(R.string.action title)) 
.setContentText(context.getString(R.string.action text) 
.setContentIntent(pendingIntent); 


String[ ] choices = 
context.getResources().getStringArray(R.array.input choices); 


Remotelnput remotelnput = new Remotelnput.Builder(ACTION EXTRA) 
.setLabel(context.getString(R.string.action label)) 
.setChoices(choices) 

-build(); 


NotificationManagerCompat.from(context).notify(8, 
new WearableNotifications.Builder(builder) 
.addRemotelnputForContentintent(remotelnput) 
-build()); 
} 


public static void showNotificationWithInputForSecondaryAction(Context context) { 
Intent intent = new Intent(ACTION_TEST); 
PendingIntent pendingIntent = 
PendingIntent.getActivity(context, 0, intent, 0); 


Remotelnput remotelnput = new Remotelnput.Builder(ACTION_EXTRA) 
.setLabel(context.getString(R.string.action label)) 
-build(); 


WearableNotifications.Action action = 
new WearableNotifications.Action.Builder( 
R.drawable.ic_launcher, 
"Action", 
pendingIntent) 
.addRemotelnput(remotelnput) 
-build(); 


Notification Compat.Builder builder = 
new NotificationCompat.Builder(context) 
.setContentTitle(context.getString(R.string.action title)); 


NotificationManagerCompat.from(context).notify(9, 
new WearableNotifications.Builder(builder) 
.addAction(action) 
-build()); 
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public static void showGroupNotifications(Context context) { 
Notification first = new WearableNotifications.Builder( 

new NotificationCompat.Builder(context) 
.SetSmalllcon(R.drawable.ic launcher) 
.setContentTitle(context.getString(R.string.page1 title) 
.setContentText(context.getString(R.string.page1 text))) 

.setGroup(NOTIFICATION GROUP) 

-build(); 


Notification second = new WearableNotifications.Builder( 
new NotificationCompat.Builder(context) 
-setSmalllcon(R.drawable.ic_launcher) 
.setContentTitle(context.getString(R.string.page2_title)) 
.setContentText(context.getString(R.string.page2 text))) 
.setGroup(NOTIFICATION GROUP) 
-build(); 


Notification summary = new WearableNotifications.Builder( 
new NotificationCompat.Builder(context) 
.setSmalllcon(R.drawable.ic_launcher) 
.setContentTitle(context.getString(R.string.summary title)) 
.setContentText(context.getString(R.string.summary text))) 
.setGroup(NOTIFICATION GROUP, WearableNotifications.GROUP ORDER SUMMARY) 
-build(); 


NotificationManagerCompat.from(context).notify(10, first); 

NotificationManagerCompat.from(context).notify(11, second); 

NotificationManagerCompat.from(context).notify(12, summary); 
} 


public static void cancelNotification(Context context, int id) { 
NotificationManagerCompat.from(context).cancel(id); 


} 


public static void cancelAllNotifications(Context context) { 
NotificationManagerCompat.from(context).cancelAlll(); 
} 
} 


到 此 为 止 , 一 个 简单 的 Android Wear 通知 程序 创建 完毕 。 执 行 后 会 实现 通知 功能 , 如 图 8-23 所 示 。 


Try the umi masu, 
it's my favorite. 


823 执行 效果 
AX Android Wear 更 多 的 演示 程序 ， 读 者 可 以 参考 官方 文档 中 的 演示 实例 。 
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第 9 章 暴走 轨迹 计 步 器 


暴走 是 指 沿 着 指定 路 线 徒步 或 驾车 行走 ， 时 间 不 限 。 暴 走 这 项 运动 源 于 美国 ， 风 靡 欧美 ， 是 一 种 
高 强度 又 简单 易 行 的 户外 运动 方式 ， 目 前 世界 上 暴走 一 族 大 约 有 7000 万 人 。 日 渐 流行 的 “暴走 ” JL 
平成 了 时 尚 、 健 身 、 释 放 、 减 压 的 代名词 。 近 年 来 随 着 全 民 健身 热潮 的 兴起 ， 为 传感器 应 用 开发 提供 
了 良好 的 舞台 。 本 章 将 通过 一 个 综合 实例 的 实现 过 程 ， 详 细 讲 解 利用 Android 传感器 技术 开发 暴走 轨 
迹 计 步 器 系统 的 方法 。 


9.1 系统 功能 模块 介绍 
GH 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 9 章 \ 系 统 功能 模块 介绍 .avi 


本 章 轨 迹 记录 器 的 功能 是 ， 通 过 Android 传感器 记录 当前 的 位 置 、 速 率 、 海 拔 、 记 录 频 率 和 距离 
等 信息 ， 并 且 可 以 将 轨迹 信息 打包 上 传 或 分 享 。 本 章 行 走 轨迹 记录 器 的 构成 模块 结构 如 图 9-1 所 示 。 
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图 9-1 系统 构成 模块 
9.2 系统 主 界面 
GE 知识 点 讲解 ， 光盘: 视频 \ 知 识 点 \ 第 9 章 \ 系 统 主 界面 .avi 


系统 主 界面 是 运行 程序 后 首先 呈现 在 用 户 面前 的 界面 。 本 节 将 详细 讲解 本 章 行 走 轨迹 记录 器 主 界 
的 具体 实现 流程 。 
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9.2.1 布局 文件 


本 系统 主 界面 的 布 
具体 实现 代码 如 下 所 示 。 
«ScrollView xmins:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/scroll" android:layout_width="fill_parent" 
android:layout height-"fill parent" android:background="#000000"> 


局 文件 是 main.xml， 功 能 是 通过 文本 控件 显示 当前 的 位 置信 息 和 传感器 信息 ， 


<LinearLayout 
android:layout_width="fill_parent" android:layout_height="fill_parent" 


android:orientation="vertical"> 
<TextView android:id="@+id/textStatus" android:layout width-"wrap content" 
android:layout height-"wrap content"/» 


<TableLayout android:id="@+id/TableGPS" 
android:layout width-"fill parent" android:layout height-"wrap content" 


android:stretchColumns="1" android:background="#000000"> 
<TableRow android:background="#333333" android:layout margin-"1dip"» 
<TextView android:id="@+id/txtDate TimeAndProvider" 
android:gravity="left" android:textStyle="bold" android:padding="2dip" 
android:layout_span="2"/> 
</TableRow> 
<TableRow android:background="#333333" android:layout margin-"1dip"» 
<TextView android:textStyle="bold" android:text="@string/txt_latitude" 
android:padding="3dip" android:textSize="17sp"/> 
<TextView android:id="@tid/txtLatitude" android:gravity-"left" 
android:padding="3dip" android:textColor="#e8a317" 
android:textStyle="bold" android:textSize="18sp"/> 


</TableRow> 
<TableRow android:background="#333333" android:layout margin-"1dip"» 


<TextView android:textStyle="bold" android:text="@string/txt_longitude" 
android: padding="3dip" android:textSize="17sp"/> 
<TextView android:id="@+id/txtLongitude" android:gravity="left" 
android: padding="3dip" android:textColor="#e8a317" 
android:textStyle="bold" android:textSize="18sp"/> 
</TableRow> 
<TableRow android:background="#333333" android:layout_margin="1dip"> 
<TextView android:id="@+id/IblAltitude" android:textStyle="bold" 
android:text="@string/txt_altitude" android:padding="3dip"/> 
<TextView android:id="@+id/txtAltitude" android:gravity-"left" 
android: padding="3dip"/> 


</TableRow> 
<TableRow android:background="#333333" android:layout_margin="1dip"> 


<TextView android:id="@tid/IbISpeed" android:textStyle="bold" 
android:text="@string/txt_speed" android:padding="3dip"/> 
<TextView android:id="@+id/txtSpeed" android:gravity-"left" 
android: padding="3dip"/> 


</TableRow> 
<TableRow android:background="#333333" android:layout_margin="1dip"> 


<TextView android:id="@+id/IlbIDirection" android:textStyle="bold" 
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android:text="@string/txt_direction" android:padding="3dip"/> 
<TextView android:id="@tid/txtDirection" android:gravity-"left" 
android:padding="3dip"/> 


</TableRow> 
<TableRow android:background="#333333" android:layout margin-"1dip"» 
<TextView android:id="@+id/IblSatellites" android:textStyle="bold" 
android:text="@string/txt_satellites" android:padding="3dip"/> 
<TextView android:id="@+id/txtSatellites" android:gravity="left" 
android: padding="3dip"/> 


</TableRow> 
<TableRow android:background="#333333" android:layout_margin="1dip"> 
<TextView android:id="@+id/IblAccuracy" android:textStyle="bold" 
android:text="@string/txt_accuracy" android:padding="3dip"/> 
<TextView android:id="@+id/txtAccuracy" android:gravity="left" 
android:padding="3dip"/> 


</TableRow> 
</TableLayout> 
«LinearLayout android:orientation="vertical" 
android:layout_width="fill_ parent" android:layout_height="wrap_content"> 
<l- 
«Button android:id="@+id/buttonStart" android:layout_width="120px" 
android:layout height-"wrap content" android:tag="Start" 
android:text="Start" /» «Button android:id="@+id/buttonStop" 
android:layout width-"120px" android:layout height-"wrap content" 
android:tag="Stop" android:text="Stop" /> 
-> 
<ToggleButton android:id="@+id/buttonOnOff " 
android:layout width-"fill parent" android:layout height-"wrap content" 
android:textOn-"(Qstring/btn stop logging" 
android:textOff="@string/btn_start_logging"/> 
</LinearLayout> 
<TableLayout android:id="@+id/TableSummary" 
android:layout_width="fill_ parent" android:layout_height="wrap_content" 
android:background="#222222"> 
<TableRow android:layout_width="fill_ parent" android:layout_height="fill_parent"> 
<TextView android:id="@+id/IblLoggingTo" android:layout_width="wrap_content" 
android:textSize-"9dip" android:layout height-"fill parent" android:textStyle="italic" 
android:paddingLeft-"8dip" android:text="@string/summary_loggingto"/> 
«TextView android:id="@+id/txtLoggingTo" android:layout width="wrap content" 
android:paddingLeft="3dip" android:textSize="9dip" android:textStyle="italic" 
android:layout_height="fill_parent"/> 


</TableRow> 
<TableRow android:layout_width="fill_parent" 
android:layout height-"fill parent"> 
<TextView android:id-"(Q)*id/IblFrequency" android:layout width-"wrap content" 
android:textSize="9dip" android:layout height-"fill parent" android:textStyle-"italic" 
android:paddingLeft-"8dip" android:text-"(g)string/summary freq every"/» 
<TextView android:id="@+id/txtFrequency" android:layout width-"wrap content" 
android:paddingLeft="3dip" android:textSize-"9dip" android:textStyle="italic" 
android:layout height-"fill parent"/> 


</TableRow> 
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<TableRow android:layout_width="fill_parent" 
android:layout height-"fill parent"> 
<TextView android:id-" (Q)*id/IblDistance" android:layout width-"wrap content" 
android:textSize-"9dip" android:layout height-"fill parent" android:textStyle="italic" 
android:paddingLeft="8dip" android:text="@string/summary_dist"/> 
<TextView android:id="@tid/txtDistance" android:layout_width="wrap_content" 
android: paddingLeft="3dip" android:textSize-"9dip" android:textStyle="italic" 
android:layout height-"fill parent"/> 
</TableRow> 
<TableRow android:layout_width="fill_parent" 
android:layout height-"fill parent"> 
<TextView android:id="@+id/IbIFileName" android:layout width-"wrap content" 
android:textSize-"9dip" android:layout height-"fill parent" android:textStyle-"italic" 
android:paddingLeft="8dip" android:text="@string/summary_current_filename"/> 
<TextView android:id="@+id/txtFileName" android:layout width-"wrap content" 
android:paddingLeft-"3dip" android:textSize-"9dip" android:textStyle-"italic" 
android:layout height-"fill parent"/» 
</TableRow> 
<TableRow android:layout_width="fill_ parent" 
android:layout_height="fill_ parent" android:id="@+id/trAutoEmail"> 
<TextView android:id-"(Q)*id/IblAutoEmail" android:layout_width="wrap_content" 
android:textSize="9dip" android:layout height-"fill parent" android:textStyle-"italic" 
android:paddingLeft="8dip" android:text="@string/summary_autoemail"/> 
<TextView android:id="@+id/txtAutoEmail" android:layout width-"wrap content" 
android:paddingLeft-"3dip" android:textSize-"9dip" android:textStyle-"italic" 
android:layout_height="fill_ parent"/» 
</TableRow> 
</TableLayout> 
<!-  «TextView android:id="@+id/IbISummary" android:layout_width="fill_parent" 
android:layout_height="wrap_content" android:textStyle="italic" 
android:textSize="1 1 dip" /> --> 
</LinearLayout> 
</ScrollView> 


9.22 SIME Activity 


本 系统 的 主 Activity 是 GpsMainActivity， 实 现 文件 是 GpsMainActivityjava， 具 体 实现 流程 如 下 。 
(1) 定义 更 新 UI 线程 的 类 GpsMainActivity， 获 取 ToggleButton 按钮 的 开关 来 显示 位 置信 息 ， 具 
体 实现 代码 如 下 所 示 。 
public class GpsMainActivity extends Activity implements OnCheckedChangeListener, 


IGpsLoggerServiceClient 
{ 
p 
* 用 处 理 器 更 新 UI 线程 
sf 


public final Handler handler = new Handler(); 
private static Intent servicelntent; 

private GpsLoggingService loggingService; 
p 
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* 提供 一 个 连接 到 GPS 记录 的 服务 
*/ 
private ServiceConnection gpsServiceConnection = new ServiceConnection() 


{ 
public void onServiceDisconnected(ComponentName name) 
{ 
loggingService = null; 
} 
public void onServiceConnected(ComponentName name, IBinder service) 
{ 
loggingService = ((GpsLoggingService.GpsLoggingBinder) service).getService(); 
GpsLoggingService.SetServiceClient(GpsMainActivity. this); 
/设置 切换 按钮 ， 显 示 现 有 的 位 置信 息 
ToggleButton buttonOnOff = (ToggleButton) findViewByld(R.id.buttonOnOff); 
if (Session.isStarted()) 
{ 
buttonOnOff.setChecked(true); 
DisplayLocationInfo(Session.getCurrentLocationlInfo()); 
} 
buttonOnOff.setOnCheckedChangeListener(GpsMainActivity.this); 
) 
y 
(2) 定义 第 一 次 创建 样式 时 触发 的 方法 ， 具 体 实 现代 码 如 下 所 示 。 


p 
* 第 一 次 创建 样式 时 触发 的 事件 
El 
@Override 
public void onCreate(Bundle savedInstanceState) 
{ 
SharedPreferences prefs = PreferenceManager.getDefaultSharedPreferences(getBaseContext()); 
String lang = prefs.getString("locale override", ""); 
if (!lang.equalsignoreCase("")) 
{ 
Locale locale = new Locale(lang); 
Locale.setDefault(locale); 
Configuration config = new Configuration(); 
config.locale = locale; 
getBaseContext().getResources().updateConfiguration(config, 
getBaseContext().getResources().getDisplayMetrics()); 
} 
super.onCreate(savedinstanceState); 
Utilities. Loginfo("GPSLogger started"); 
setContentView(R.layout.main); 
GetPreferences(); 
StartAndBindService(); 
} 
(3) 启动 定位 服务 并 绑 定 到 当前 的 Activit 界面 ， 具 体 实现 代码 如 下 所 示 。 
private void StartAndBindService() 


{ 
Utilities. LogDebug("StartAndBindService - binding now"); 
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servicelntent = new Intent(this, GpsLoggingService.class); 
II Start the service in case it isn't already running 
startService(servicelntent); 
11 Now bind to service 
bindService(servicelntent, gpsServiceConnection, Context.BIND AUTO CREATE); 
Session.setBoundToService(true); 

} 

(4) 当 按钮 关闭 则 停止 系统 的 监听 服务 ， 具 体 实 现代 码 如 下 所 示 。 
private void StopAndUnbindServicelfRequired() 


{ 
if(Session.isBoundToService()) 
{ 
unbindService(gpsServiceConnection); 
Session.setBoundToService(false); 
} 
if(ISession.isStarted()) 
{ 
Utilities.LogDebug("StopServicelfRequired - Stopping the service"); 
IIservicelntent = new Intent(this, GpsLoggingService.class); 
stopService(servicelntent); 
} 
} 
@Override 
protected void onPause() 
{ 
StopAndUnbindServicelfRequired(); 
super.onPause(); 
} 
@Override 
protected void onDestroy() 
{ 
StopAndUnbindServicelfRequired(); 
super.onDestroy(); 
} 


(5) 当 切 换 按钮 被 单 击 时 调用 方法 onCheckedChanged， 具 体 实 现代 码 如 下 所 示 。 
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) 
{ 


if (isChecked) 
{ 
GetPreferences(); 
loggingService.StartLogging(); 
} 
else 
{ 
loggingService.StopLogging(); 
} 
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(6) 根据 用 户 设置 选项 值 显 示 一 个 具有 良好 可 读 性 的 视图 界面 ， 具 体 实现 代码 如 下 所 示 。 


private void ShowPreferencesSummary() 


{ 


TextView txtLoggingTo = (TextView) findViewByld(R.id.txtLoggingTo); 
TextView txtFrequency = (TextView) findViewByld(R.id.txtFrequency); 
TextView txtDistance = (TextView) findViewByld(R.id.txtDistance); 
TextView txtAutoEmail = (TextView) findViewByld(R.id.txtAutoEmail); 

if (IAppSettings.shouldLogToKml() && !AppSettings.shouldLogToGpx()) 


{ 
txtLoggingTo.setText(R.string.summary_loggingto_screen); 
} 
else if (AppSettings.shouldLogToGpx() && AppSettings.shouldLogToKml()) 
{ 
txtLoggingTo.setText(R.string.summary_loggingto_both); 
} 
else 
{ 
txtLoggingTo.setText((AppSettings.shouldLogToGpx() ? "GPX" : "KML")); 
} 
if (AppSettings.getMinimumSeconds() > 0) 
{ 
String descriptive Time = Utilities. GetDescriptiveTimeString(AppSettings.getMinimumSeconds(), 
getBaseContext()); 
txtFrequency.setText(descriptive Time); 
) 
else 
{ 
txtFrequency.setText(R.string.summary freq max); 
} 
if (AppSettings.getMinimumDistance() > 0) 
{ 
if (AppSettings.shouldUselmperial()) 
{ 
int minimumDistancelnFeet = Utilities. Meters ToFeet(AppSettings.getMinimumDistance()); 
txtDistance.setText(((minimumDistancelnFeet == 1) 
? getString(R.string.foot) 
: String.valueOf(minimumDistancelnFeet) + getString(R.string.feet))); 
} 
else 
{ 
txtDistance.setText(((AppSettings.getMinimumDistance() == 1) 
? getString(R.string.meter) 
: String.valueOf(AppSettings.getMinimumDistance()) + getString(R.string.meters))); 
} 
} 
else 
{ 
txtDistance.setText(R.string.summary dist regardless); 
) 
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if (AppSettings.isAutoEmailEnabled()) 


{ 
String autoEmailResx; 
if (AppSettings.getAutoEmailDelay() == 0) 
{ 
autoEmailResx = "autoemail frequency whenistop"; 
) 
else 
{ 
autoEmailResx = "autoemail frequency " 
+ String.valueOf(AppSettings.getAutoEmailDelay ()).replace(".", ""); 
/I.replace(".0", "") 
} 
String autoEmailDesc = getString(getResources().getldentifier(autoEmailResx, "string", getPackage 
Name())); 
I String autoEmailDesc = getString(getResources().getldentifier( 
I getPackageName()+ ":string/" + autoEmailResx, null, null)); 
txtAutoEmail.setText(autoEmailDesc); 
} 
else 
{ 
TableRow trAutoEmail = (TableRow) findViewByld(R.id.trAutoEmail); 
trAutoEmail.setVisibility(View.INVISIBLE); 
} 


} 
(7) 根据 用 户 选 择 的 菜单 项 调用 执行 不 同 的 处 理 方法 ， 具 体 实现 代码 如 下 所 示 。 
public boolean onOptionsltemSelected(Menultem item) 
int itemld = item.getltemld(); 
Utilities.LogInfo("Option item selected - " + String.valueOf(item.getTitle())); 
Switch (itemld) 
{ 
case R.id.mnuSettings: 
Intent settingsActivity = new Intent(getBaseContext(), GpsSettingsActivity class); 
startActivity(settingsActivity); 
break; 
case R.id.mnuOSM: 
UploadToOpenStreetMap(); 
break; 
case R.id.mnuAnnotate: 
Annotate(); 
break; 
case R.id.mnuShare: 
Share(); 
break; 
case R.id.mnuEmailnow: 
EmailNow(); 
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break; 
case R.id.mnuExit: 
loggingService.StopLogging(); 
loggingService.stopSelf(); 
System.exit(0); 
break; 
} 
return false; 
} 
private void EmailNow() 
{ 
if(Utilities.lsEmailSetup(getBaseContext())) 
{ 
loggingService.ForceEmailLogFile(); 
} 
else 
{ 
Intent emailSetup = new Intent(getBaseContext(), AutoEmailActivity.class); 
startActivity(emailSetup); 
} 
} 


(8) 通过 方法 Share 实现 轨迹 分 享 功能 ， 允 许 用 户 发 送 带 位 置 的 GPXKML 文件 的 位 置 ， 或 者 只 
使 用 一 个 提供 者 ， 可 以 使 用 的 分 享 方式 有 Facebook、 和 短信、 电子 邮件 、 推 特 和 蓝牙 。 方 法 Share 的 具 
体 实现 代码 如 下 所 示 。 


private void Share() 
{ 

ty 

{ 


final String locationOnly = getString(R.string.sharing location only); 
final File gpxFolder = new File(Environment.getExternalStorageDirectory(), "GPSLogger"); 
if (gpxFolder.exists()) 
{ 
String[ ] enumeratedFiles = gpxFolder.list(); 
List<String> fileList = new ArrayList<String>(Arrays.asList(enumeratedFiles)); 
Collections.reverse(fileList); 
fileList.add(0, locationOnly); 
final String[ ] files = fileList.toArray(new String[0]); 
final Dialog dialog = new Dialog(this); 
dialog.setTitle(R.string.sharing pick file); 
dialog.setContentView(R.layout.filelist); 
ListView thelist = (ListView) dialog.findViewByld(R.id.listViewFiles); 
thelist.setAdapter(new ArrayAdapter<String>(getBaseContext(), 
android.R.layout.simple list item single choice, files)); 
thelist.setOnItemClickListener(new OnltemClickListener() 
{ 
public void onltemClick(AdapterView<?> av, View v, int index, long arg) 
{ 
dialog.dismiss(); 
String chosenFileName = files[index]; 
final Intent intent = new Intent(Intent.ACTION SEND); 
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II intent.setType("text/plain"); 
intent.setType("*/*"); 
if (chosenFileName.equalslgnoreCase(locationOnly)) 
{ 
intent.setType("text/plain"); 
) 
intent.putExtra(Intent.EXTRA_SUBJECT, getString(R.string.sharing mylocation)); 
if (Session.hasValidLocation()) 
{ 

String bodyText = getString(R.string.sharing latlong text, 
String.valueOf(Session.getCurrentLatitude()), 
String.valueOf(Session.getCurrentLongitude())); 

intent.putExtra(Intent. EXTRA TEXT, bodyText); 

intent.putExtra("sms body", bodyText); 
) 
if (chosenFileName.length() > 0 
&& !chosenFileName.equalslgnoreCase(locationOnly)) 


{ 
intent.putExtra(Intent. EXTRA STREAM, 
Uri.fromFile(new File(gpxFolder, chosenFileName))); 
} 
startActivity(Intent.createChooser(intent, getString(R.string.sharing_via))); 
} 
» 
dialog.show(); 
} 
else 
{ 
Utilities. MsgBox(getString(R.string.sorry), getString(R.string.no_files_found), this); 
} 
} 
catch (Exception ex) 
{ 
Utilities.LogError("Share", ex); 
} 


(9) 编写 方法 UploadToOpenStreetMap 上 传 一 个 跟踪 GPS 记录 的 对 象 ， 具 体 实 现代 码 如 下 所 示 。 


private void UploadToOpenStreetMap() 


{ 


if('Utilities.IlSOsmAuthorized(getBaseContext())) 


d 
startActivity(Utilities.GetOsmSettingsIntent(getBaseContext())); 
retum; 


} 
final String goToOsmSettings = getString(R.string.menu_settings); 


final File gpxFolder = new File(Environment.getExternalStorageDirectory(), "GPSLogger ); 
if (gpxFolder.exists()) 
{ 


FilenameFilter select = new FilenameFilter() 
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{ 
public boolean accept(File dir, String filename) 
{ 
return filename.toLowerCase().contains(".gpx"); 
} 
Е 


String[ ] enumeratedFiles = gpxFolder.list(select); 
List<String> fileList = new ArrayList<String>(Arrays.asList(enumeratedFiles)); 
Collections.reverse(fileList); 
fileList.add(0, goToOsmSettings); 
final String[ ] files = fileList.toArray(new String[0]); 
final Dialog dialog = new Dialog(this); 
dialog.setTitle(R.string.osm pick file); 
dialog.setContentView(R. layout filelist); 
ListView thelist = (ListView) dialog. findViewByld(R.id.listViewFiles); 
thelist.setAdapter(new ArrayAdapter<String>(getBaseContext(), 
android.R.layout.simple_list_item_single_choice, files)); 
thelist.setOnltemClickListener(new OnltemClickListener() 
{ 
public void onltemClick(AdapterView<?> av, View v, int index, long arg) 
{ 


dialog.dismiss(); 
String chosenFileName = files[index]; 


if(chosenFileName.equalslgnoreCase(goToOsmSettings)) 
{ 


} 


else 


{ 


startActivity(Utilities. GetOsmSettingsIntent(getBaseContext())); 


OSMHelper osm = new OSMHelper(GpsMainActivity this); 

Utilities. ShowProgress(GpsMainActivity.this, getString(R.string.osm_uploading), getString 
(R.string.please_wait)); 

osm.UploadGpsTrace(chosenFileName); 


} 
} 
ys 
dialog.show(); 
} 
else 
{ 
Utilities. MsgBox(getString(R.string.sorry), getString(R.string.no files found), this); 
} 
} 
(10) 通过 方法 Annotate 提示 用 户 输入 ， 然 后 添加 文本 日 志文 件 ， 具 体 实现 代码 如 下 所 示 。 
private void Annotate() 
{ 


if (IAppSettings.shouldLogToGpx() && IAppSettings.shouldLogToKml()) 
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{ 
return; 
) 
if (ISession.shoulAllowDescription()) 
{ 
Utilities. MsgBox(getString(R.string.not_yet), 
getString(R.string.cant add description until next point), 
GetActivity()); 
return; 
} 


AlertDialog.Builder alert = new AlertDialog.Builder(GpsMainActivity.this); 
alert.setTitle(R.string.add_description); 
alert.setMessage(R.string.letters_numbers); 

/设置 一 个 EditText 视图 用 来 获取 用 户 的 输入 

final EditText input = new EditText(getBaseContext()); 


alert.setView(input); 
alert.setPositiveButton(R.string.ok, new Dialoginterface.OnClickListener() 
{ 
public void onClick(DialogInterface dialog, int whichButton) 
{ 
final String desc = Utilities. CleanDescription(input.getText().toString()); 
Annotate(desc); 
} 
» 
alert.setNegativeButton(R.string.cancel, new DialogInterface.OnClickListener() 
{ 
public void onClick(DialogInterface dialog, int whichButton) 
{ 
II Cancelled. 
} 
» 
alert.show(); 


) 
(11) 编写 方法 ClearForm 清理 当前 屏幕 视图 ， 并 删除 所 有 获取 的 值 。 具 体 实现 代码 如 下 所 示 。 
public void ClearForm() 
{ 
TextView tvLatitude = (TextView) findViewByld(R.id.txtLatitude); 
TextView tvLongitude = (TextView) findViewByld(R.id.txtLongitude); 
TextView tvDateTime = (TextView) findViewByld(R.id.txtDate TimeAndProvider); 
TextView tvAltitude = (TextView) findViewByld(R.id.txtAltitude); 
TextView txtSpeed = (TextView) findViewByld(R.id.txtSpeed); 
TextView txtSatellites = (TextView) findViewByld(R.id.txtSatellites); 
TextView txtDirection = (TextView) findViewByld(R.id.txtDirection); 
TextView txtAccuracy = (TextView) findViewByld(R.id.txtAccuracy); 
tvLatitude.setText(""); 
tvLongitude.setText(""); 
tvDateTime.setText(""); 
tvAltitude.setText(""); 
txtSpeed.setText(""); 
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txtSatellites.setText(”); 

txtDirection.setText(""); 

txtAccuracy.setText(""); 
} 
(12) 在 顶部 的 状态 标签 设置 信息 ， 具 体 实现 代码 如 下 所 示 。 
private void SetStatus(String message) 


{ 
TextView tvStatus = (TextView) findViewByld(R.id.textStatus); 
tvStatus.setText(message); 
Utilities.LogInfo(message); 

) 


(3) 设置 表 中 的 卫星 视图 ， 具 体 实现 代码 如 下 所 示 。 
private void SetSatelliteInfo(int number) 


{ 
Session.setSatelliteCount(number); 
TextView txtSatellites = (TextView) findViewByld(R.id.txtSatellites); 
txtSatellites.setText(String.valueOf(number)); 

) 


(14) 处 理 指定 的 位 置 坐标 ， 并 将 结果 显示 在 视图 中 。 具 体 实现 代码 如 下 所 示 。 


private void DisplayLocationInfo(Location loc) 


{ 
try 
{ 
if (loc == null) 
{ 
return; 
) 


Session.setLatestTimeStamp(System.currentTimeMillis()); 
TextView tvLatitude = (TextView) findViewByld(R.id.txtLatitude); 
TextView tvLongitude = (TextView) findViewByld(R.id.txtLongitude); 
TextView tvDateTime = (TextView) findViewByld(R.id.txtDateTimeAndProvider); 
TextView tvAltitude = (TextView) findViewByld(R.id.txtAltitude); 
TextView txtSpeed = (TextView) findViewByld(R.id.txtSpeed); 
TextView txtSatellites = (TextView) findViewByld(R.id.txtSatellites); 
TextView txtDirection = (TextView) findViewByld(R.id.txtDirection); 
TextView txtAccuracy = (TextView) findViewByld(R.id.txtAccuracy); 
String providerName = loc.getProvider(); 

if (providerName.equalslgnoreCase("gps")) 


{ 
providerName = getString(R.string.providername_gps); 
} 
else 
{ 
providerName = getString(R.string.providername_celltower); 
} 


tvDateTime.setText(new Date().toLocaleString() 

+ getString(R.string.providername using, providerName)); 
tvLatitude.setText(String. valueOf(loc.getLatitude())); 
tvLongitude.setText(String.valueOf(loc.getLongitude())); 
if (loc.hasAltitude()) 
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{ 
double altitude = loc.getAltitude(); 
if (AppSettings.shouldUselmperial()) 
{ 
tvAltitude.setText(String. valueOf( Utilities. Meters ToFeet(altitude)) 
+ getString(R.string.feet)); 
} 
else 
{ 
tvAltitude.setText(String. valueOf(altitude) + getString(R.string.meters)); 
} 
} 
else 
{ 
tvAltitude.setText(R.string.not_applicable); 
} if (loc.hasSpeed()) 
{ 
float speed = loc.getSpeed(); 
if (AppSettings.shouldUselmperial()) 
{ 
txtSpeed.setText(String.valueOf(Utilities. Meters ToFeet(speed)) 
+ getString(R.string.feet per second)); 
) 
else 
{ 
txtSpeed.setText(String.valueOf(speed) + getString(R.string.meters_per_second)); 
} 
} 
else 
{ 
txtSpeed.setText(R.string.not_applicable); 
} 
if (loc.hasBearing()) 
{ 
float bearingDegrees = loc.getBearing(); 
String direction; 
direction = Utilities. GetBearingDescription(bearingDegrees, getBaseContext()); 
txtDirection.setText(direction + "("  String.valueOf(Math.round(bearingDegrees)) 
+ getString(R.string.degree symbol) + ")"); 
} 
else 
{ 
txtDirection.setText(R.string.not_applicable); 
} 
if (ISession.isUsingGps()) 
{ 
txtSatellites.setText(R.string.not_applicable); 
Session.setSatelliteC ount(0); 
} 
if (loc.hasAccuracy()) 
{ 
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float accuracy = loc.getAccuracy(); 
if (AppSettings.shouldUselmperial()) 


{ 
txtAccuracy.setText(getString(R.string.accuracy within, 
String.valueOf(Utilities.Meters ToFeet(accuracy)), getString(R.string.feet))); 
) 
else 
{ 
txtAccuracy.setText(getString(R.string.accuracy_within, String.valueOf(accuracy), 
getString(R.string.meters))); 
} 
} 
else 
{ 
txtAccuracy.setText(R.string.not_applicable); 
} 
} 
catch (Exception ex) 
£ 
SetStatus(getString(R.string.error_displaying, ex.getMessage())); 
} 


} 
ТЕЕ: Activity 的 实现 过 程 中 用 到 了 系统 服务 Activity， 其 实现 文件 是 GpsLoggingServicejava， 功 能 
是 提供 了 本 系统 所 需要 的 后 台 服 务 方 法 。 文 件 GpsLoggingService.java 的 具体 实现 流程 如 下 所 示 。 
CD 定义 可 以 调用 的 类 和 方法 ， 具 体 实现 代码 如 下 所 示 。 
class GpsLoggingBinder extends Binder 


{ 
public GpsLoggingService getService() 
{ 
Utilities.LogDebug("GpsLoggingBinder.getService"); 
return GpsLoggingService.this; 
) 
) 


(2) 建立 基于 用 户 偏好 设置 的 电邮 自动 计时 器 ， 具 体 实现 代码 如 下 所 示 。 
private void SetupAutoEmailTimers() 
{ 
Utilities.LogDebug("GpsLoggingService.SetupAutoEmailTimers"); 
Utilities.LogDebug("isAutoEmailEnabled - " + String.valueOf(AppSettings.isAutoEmailEnabled())); 
Utilities. LogDebug("Session.getAutoEmailDelay - " + String.valueOf(Session.getAutoEmailDelay())); 
if (AppSettings.isAutoEmailEnabled() && Session.getAutoEmailDelay() > 0) 
{ 
Utilities.LogDebug("Setting up email alarm"); 
long triggerTime = System.currentTimeMillis() 
* (long) (Session.getAutoEmailDelay() * 60 * 60 * 1000); 
alarmintent = new Intent(getBaseContext(), AlarmReceiver.class); 
PendingIntent sender = PendingIntent.getBroadcast(this, 0, alarmintent, 
Pendinglntent.FLAG UPDATE CURRENT); 
AlarmManager am - (AlarmManager) getSystemService(ALARM SERVICE); 
am.set(AlarmManager.RTC_WAKEUP, triggerTime, sender); 
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else 


Utilities.LogDebug("Checking if alarmintent is null"); 

if (alarmintent != null) 

{ 
Utilities. LogDebug("alarmlntent was null, canceling alarm"); 
CancelAlarm(); 


} 
} 
(3) 如 果 调 用 用 户 选择 自动 邮件 日 志文 件 方法 则 停止 记录 操作 ， 具 体 实现 代码 如 下 所 示 。 
private void AutoEmailLogFileOnStop() 
{ 
Utilities.LogDebug("GpsLoggingService.AutoEmailLogFileOnStop"); 
Utilities.LogVerbose("isAutoEmailEnabled - " + AppSettings.isAutoEmailEnabled()); 
11 autoEmailDelay 0 means send it when you stop logging. 
if (AppSettings.isAutoEmailEnabled() && Session.getAutoEmailDelay() == 0) 
{ 
Session.setEmailReadyToBeSent(true); 
AutoEmailLogFile(); 
) 
) 
(4) 调用 自动 电子 邮件 辅助 处 理 文件 并 将 其 发 送 ， 具 体 实 现代 码 如 下 所 示 。 
private void AutoEmailLogFile() 
{ 
Utilities. LogDebug("GpsLoggingService.AutoEmailLogFile"); 
Utilities.LogVerbose("isEmailReady ToBeSent - " + Session.isEmailReadyToBeSent()); 
if (Session.getCurrentFileName() != null && Session.getCurrentFileName().length() > 0 
&& Session.isEmailReadyToBeSent()) 
{ 
if(IsMainFormVisible()) 
{ 
Utilities. ShowProgress(mainServiceClient.GetActivity(), getString(R.string.autoemail sending), 
getString(R.string.please wait)); 
} 
Utilities.LogInfo("Emailing Log File"); 
AutoEmailHelper aeh = new AutoEmailHelper(GpsLoggingService.this); 
aeh.SendLogFile(Session.getCurrentFileName(), false); 
SetupAutoEmailTimers(); 


if(IsMainFormVisible()) 
{ 
Utilities. HideProgress(); 
5 
} 

} 
protected void ForceEmailLogFile() 
{ 


Utilities. LogDebug("GpsLoggingService.ForceEmailLogFile"); 
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} 


if (Session.getCurrentFileName() != null && Session.getCurrentFileName().length() > 0) 
{ 
if(IsMainFormVisible()) 
{ 
Utilities. ShowProgress(mainServiceClient.GetActivity(), getString(R.string.autoemail_sending), 
getString(R.string.please_wait)); 
} 
Utilities.LogInfo("Force emailing Log File"); 
AutoEmailHelper aeh = new AutoEmailHelper(GpsLoggingService.this); 
aeh.SendLogFile(Session.getCurrentFileName(), true); 


if(IsMainFormVisible()) 
{ 


} 


Utilities. HideProgress(); 


} 


(5) 设置 此 服务 的 活动 形式 ， 活 动 形式 需要 调用 igpsloggerserviceclient， 有 具体 实现 代码 如 下 所 示 。 


protected static void SetServiceClient(IGpsLoggerServiceClient mainForm) 


如 下 所 示 。 
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{ 
mainServiceClient = mainForm; 
} 
(6) 根据 用 户 的 偏好 设置 选择 和 填充 appSettings 对 象 ， 并 设置 电子 邮件 的 定时 器 ， 具 体 实 现代 码 
private void GetPreferences() 
{ 
Utilities. LogDebug("GpsLoggingService.GetPreferences"); 
Utilities. PopulateA pp Settings(getBaseContext()); 
Utilities. LogDebug("Session.getAutoEmailDelay: " + Session.getAutoEmailDelay()); 
Utilities. LogDebug("AppSettings.getAutoEmailDelay: " + AppSettings.getAutoEmailDelay()); 
if (Session.getAutoEmailDelay() != AppSettings.getAutoEmailDelay()) 
{ 
Utilities.LogDebug("Old autoEmailDelay - " + String.valueOf(Session.getAutoEmailDelay()) 
+"; New -" + String.valueOf(AppSettings.getAutoE mailDelay())); 
Session.setAutoEmailDelay(AppSettings.getAutoEmailDelay()); 
SetupAutoEmailTimers(); 
) 
) 
(7) 实现 复位 处 理 ， 具 体 实现 代码 如 下 所 示 。 
protected void StartLogging() 
{ 


Utilities. LogDebug("GpsLoggingService.StartLogging"); 
Session.setAddNewTrackSegment(true); 
if (Session.isStarted()) 
{ 

return; 
} 
Utilities. Loginfo("Starting logging procedures"); 
startForeground(NOTIFICATION_ID, null); 
Session.setStarted(true); 
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GetPreferences(); 
Notify(); 
ResetCurrentFileName(); 
ClearForm(); 
StartGpsManager(); 
} 
(8) 停止 记录 ， 删 除 通知 ， 停 止 GPS 经 理 ， 通 过 定时 器 停止 邮件 ， 具 体 实现 代码 如 下 所 示 。 
protected void StopLogging() 
{ 
Utilities.LogDebug("GpsLoggingService.StopLogging"); 
Session.setAddNewTrackSegment(true); 
Utilities. Loginfo("Stopping logging"); 
Session.setStarted(false); 
II Email log file before setting location info to null 
AutoEmailLogFileOnStop(); 
CancelAlarm(); 
Session.setCurrentLocationlnfo(null); 
stopForeground(true); 
RemoveNotification(); 
StopGpsManager(); 
StopMainActivity(); 
} 
(9) 在 状态 栏 中 显示 通知 ， 有 具体 实现 代码 如 下 所 示 。 
private void Notify() 
{ 


Utilities. LogDebug("GpsLoggingService.Notify"); 
if (AppSettings.shouldShowInNotificationBar()) 
{ 


gpsNotifyManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE); 
ShowNotification(); 
} 


else 


{ 
} 


RemoveNotification(); 


} 
(10) 如 果 图 标 是 可 见 的 则 隐藏 状态 栏 中 的 通知 ， 具 体 实 现代 码 如 下 所 示 。 
private void RemoveNotification() 
{ 
Utilities.LogDebug("GpsLoggingService.RemoveNotification"); 
try 


{ 
if (Session.isNotificationVisible()) 


{ 
gpsNotifyManager.cancelAll(); 
} 
catch (Exception ex) 


Utilities.LogError("RemoveNotification", ex); 
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} 


} 
finally 
{ 
II notificationVisible = false; 
Session.setNotificationVisible(false); 
} 


(11) 在 状态 栏 中 显示 GPS 记录 器 的 通知 图 标 ， 具 体 实现 代码 如 下 所 示 。 
private void ShowNotification() 


{ 


} 


Utilities.LogDebug("GpsLoggingService.ShowNotification"); 
II What happens when the notification item is clicked 
Intent contentintent = new Intent(this, GpsMainActivity.class); 
Pendinglntent pending = PendingIntent.getActivity(getBaseContext(), 0, contentIntent, 
android.content.Intent.FLAG ACTIVITY NEW TASK); 
Notification nfc = new Notification(R.drawable.gpsloggericon2, null, System.currentTimeMillis()); 
nfc.flags |= Notification.FLAG ONGOING EVENT; 
NumberFormat nf = new Оесїта!Еогта{("###.######"); 
String contentText 7 getString(R.string.gpslogger still running); 
if (Session.hasValidLocation()) 
İl if (currentLatitude != 0 && currentLongitude != 0) 
{ 
contentText = nf.format(Session.getCurrentLatitude()) + "," 
+ nf.format(Session.getCurrentLongitude()); 
} 
nfc.setLatestEventInfo(getBaseContext(), getString(R.string.gpslogger_still_running), 
contentText, pending); 
gpsNotifyManager.notify(NOTIFICATION ID, nfc); 
Session.setNotificationVisible(true); 


(12) 根据 用 户 的 偏好 设置 选项 启动 GPS 功能 ， 有 具体 实现 代码 如 下 所 示 。 
private void StartGpsManager() 


{ 


Utilities. LogDebug("GpsLoggingService.StartGpsManager"); 
GetPreferences(); 
gpsLocationListener = new GeneralLocationListener(this); 
towerLocationListener = new GeneralLocationListener(this); 
gpsLocationManager = (LocationManager) getSystemService(Context.LOCATION_SERVICE); 
towerLocationManager = (LocationManager) getSystemService(Context.LOCATION SERVICE); 
CheckTowerAndGpsStatus(); 
if (Session.isGpsEnabled() && !AppSettings.shouldPreferCellTower()) 
{ 
Utilities.LogInfo("Requesting GPS location updates"); 
/ gps satellite based 
gpsLocationManager.requestLocationUpdates(LocationManager.GPS PROVIDER, 
AppSettings.getMinimumSeconds() * 1000, AppSettings.getMinimumDistance(), 
gpsLocationListener); 
gpsLocationManager.addGpsStatusListener(gpsLocationListener); 
Session.setUsingGps(true); 


} 
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else if (Session.isTowerEnabled()) 


{ 
Utilities.LogInfo("Requesting tower location updates"); 
Session.setUsingGps(false); 
II isUsingGps = false; 
II Cell tower and wifi based 
towerL ocationManager.requestLocationUpdates(LocationManager. NETWORK PROVIDER, 
AppSettings.getMinimumSeconds() * 1000, AppSettings.getMinimumDistance(), 
towerLocationListener); 
} 
else 
{ 
Utilities.LogInfo("No provider available"); 
Session.setUsingGps(false); 
SetStatus(R.string.gpsprovider_unavailable); 
SetFatalMessage(R.string.gpsprovider_unavailable); 
StopLogging(); 
return; 
} 
SetStatus(R.string.started); 


(13) 周期 性 检查 是 否 已 经 启动 GPS 和 信号 塔 ， 具 体 实现 代码 如 下 所 示 。 


private void CheckTowerAndGpsStatus() 


{ 


Session.setTowerEnabled(towerLocationManager.isProviderEnabled(LocationManager. NETWORK PROVIDER)); 
Session.setGpsEnabled(gpsLocationManager.isProviderEnabled(LocationManager.GPS PROVIDER)); 


) 


(14) 停止 位 置 管理 服务 ， 具 体 实现 代码 如 下 所 示 。 


private void StopGpsManager() 


{ 


} 


Utilities. LogDebug("GpsLoggingService.StopGpsManager"); 
if (towerLocationListener != null) 


{ 
towerLocationManager.removeUpdates(towerLocationListener); 
} 
if (gpsLocationListener != null) 
{ 
gpsLocationManager.removeUpdates(gpsLocationListener); 
gpsLocationManager.removeGpsStatusListener(gpsLocationListener); 
} 


SetStatus(getString(R.string.stopped)); 


(15) 基于 用 户 偏好 设置 当前 文件 名 ， 有 具体 实现 代码 如 下 所 示 。 


private void ResetCurrentFileName() 


{ 


Utilities.LogDebug("GpsLoggingService.ResetCurrentFileName"); 
String newFileName; 
if (AppSettings.shouldCreateNewFileOnceADay()) 


{ 
II 20100114.9px 
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SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMdd"); 


newFileName = sdf.format(new Date()); 
Session.setCurrentFileName(newFileName); 


} 
else 
{ 
11 20100114183329.gpx 
SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMddHHmmss"); 
newFileName = sdf.format(new Date()); 
Session.setCurrentFileName(newFileName); 
} 
if (IsMainFormVisible()) 
{ 
mainServiceClient.onFileName(newFileName); 
} 


} 
(16) 为 客户 端 显示 一 个 状态 信息 ， 有 具体 实现 代码 如 下 所 示 。 
void SetStatus(String status) 


{ 
if (IsMainFormVisible()) 
{ 
mainServiceClient.OnStatusMessage(status); 
} 
} 


到 此 为 止 ， 系 统 的 主 Activity 和 服务 Activity 的 实现 过 程 介 绍 


完毕 ， 执 行 后 的 效果 如 图 9-2 所 示 。 


点 击 设备 中 的 MENU 按钮 后 ， 在 屏幕 下 方 弹出 选项 设置 界面 ， 如 图 9-3 所 示 。 


图 9-2 系统 主 界面 图 9-3 屏幕 下 方 弹出 选项 设置 界面 


93 系统 设置 


知识 点 讲解 : 光盘 :视频 \ 知 识 点 第 9 章 \ 系 统 设置 .avi 
当选 择 图 9-3 中 的 Settings 选项 后 ， 会 弹出 系统 设置 界面 ， 如 


图 9-4 所 示 。 
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|GPSLogger: 
Log to GPX 


Log to KML 


Logging details 
General Options 


Email and Upload 


图 9-4 系统 设置 界面 


在 系统 设置 界面 中 ， 可 以 设置 系统 的 常用 选项 参数 。 在 本 节 的 内 容 中 ， 将 详细 讲解 系统 设置 模块 
的 实现 过 程 。 


9.3.1 选项 设置 


编写 文件 AppSettings.java, 功能 是 根据 用 户 各 个 选项 的 值 来 设置 系统 , 例如 设置 保存 为 GPX (GPS 
eXchange Format 的 缩写 ， 译 为 GPS 交换 格式 ， 是 一 个 XML 格式 ， 为 应 用 软件 设计 的 通用 GPS 数据 
格式 ， 可 以 用 来 描述 路 点 、 轨 迹 、 路 程 ) 格式 数据 文件 或 KML (是 一 种 文件 格式 ， 用 于 在 地 球 浏览 器 
中 显示 地 理 数据 , 例如 Google HER, Google 地 图 和 谷歌 手机 地 图 ) 格 式 数据 文件 。 文 件 AppSettings.java 
的 具体 实现 代码 如 下 所 示 。 

public class AppSettings extends Application 

{ 


Jes l A a 


/用 户 设置 


private static boolean uselmperial = false; 
private static boolean newFileOnceADay; 
private static boolean preferCellTower; 
private static boolean useSatelliteTime; 
private static boolean logToKml; 

private static boolean logToGpx; 

private static boolean showInNotificationBar; 
private static int minimumDistance; 

private static int minimumSeconds; 

private static String newFileCreation; 

private static Float autoEmailDelay = Of; 
private static boolean autoEmailEnabled = false; 
private static String smtpServer; 

private static String smtpPort; 

private static String smtpUsername; 

private static String smtpPassword; 

private static String autoEmailTarget; 

private static boolean smtpSsl; 

private static boolean debugToFile; 

public static boolean shouldUselmperial() 


{ 
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return uselmperial; 
} 
static void setUselmperial(boolean uselmperial) 


{ 


AppSettings.uselmperial = uselmperial; 


p 
* @retum the 一 天 更 新 一 个 新 文件 
qj 
public static boolean shouldCreateNewFileOnceADay() 
{ 


} 
static void setNewFileOnceADay(boolean newFileOnceADay) 


( 


return newFileOnceADay; 


AppSettings.newFileOnceADay = newFileOnceADay; 


} 
public static boolean shouldPreferCellTower() 
{ 
return preferCellTower; 
} 


static void setPreferCellTower(boolean preferCellTower) 
{ 


} 
public static boolean shouldUseSatellite Time() 


í 


) 
static void setUseSatelliteTime(boolean useSatellite Time) 


{ 


AppSettings.preferCellTower = preferCellTower; 


return useSatelliteTime; 


AppSettings.useSatelliteTime = useSatellite Time; 


P static boolean shouldLogToKml() 

! return logToKml; 

E void setLogToKml(boolean logToKml) 
i AppSettings.logToKml = logToKml; 
‘ide static boolean shouldLogToGpx() 

f return logToGpx; 

ae void setLogToGpx(boolean logToGpx) 
AppSettings.logToGpx = logToGpx; 

} 


public static boolean shouldShowlnNotificationBar() 
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return showInNotificationBar; 


Jem void setShowInNotificationBar(boolean showInNotificationBar) 
; AppSettings.showlInNotificationBar = showInNotificationBar; 
static int getMinimumDistance() 
return minimumDistance; 
m void setMinimumDistance(int minimumDistance) 
| AppSettings.minimumDistance = minimumDistance; 
a static int getMinimumSeconds() 
А retum minimumSeconds; 
} 
p 
* (param minimumSeconds 
c the minimumSeconds to set 
a void setMinimumSeconds(int minimumSeconds) 
| AppSettings.minimumSeconds = minimumSeconds; 
} 

9.3.2 生成 GPX 文件 和 KML 文件 

在 系统 设置 界面 中 ， 可 以 指定 一 个 文件 来 保存 我 们 的 行走 轨迹 。 本 系统 提供 了 两 种 保存 轨迹 的 文 


件 格式 ， 分 别 是 GPX 和 KML， 如 图 9-5 所 示 。 


Log to GPX 


Log to KML 


Logging details 


General Options 


Email and Upload 


图 9-5 设置 保存 轨迹 的 文件 格式 


(1) 编写 文件 Gpx10FileLoggerjava 生成 GPX 格式 的 文件 ， 具 体 实现 代码 如 下 所 示 。 
class Gpx10FileLogger implements IFileLogger 
( 


private final static Object lock = new Object(); 
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@ 


private File gpxFile = null; 

private boolean useSatellite Time = false; 

private boolean addNewTrackSegment; 
private int satelliteCount; 


Gpx10Fi 
d 


ileLogger(File gpxFile, boolean useSatellite Time, boolean addNewTrackSegment, int satelliteCount) 


this.gpxFile = gpxFile; 
this.useSatelliteTime = useSatelliteTime; 
this.addNewTrackSegment = addNewTrackSegment; 


satelliteCount = satelliteCount; 


public void Write(Location loc) throws Exception 


this. 
} 
{ 
try 
í 


Date now; 
if (useSatelliteTime) 
{ 
now = new Date(loc.getTime()); 
} 
else 
{ 
now = new Date(); 
} 


String dateTimeString = Utilities.GetlsoDateTime(now); 


if (!gpxFile.exists()) 
{ 
gpxFile.createNewFile(); 
FileOutputStream initialWriter = new FileOutputStream(gpxFile, true); 
BufferedOutputStream initialOutput = new BufferedOutputStream(initialWriter); 
String initialXml = "<?xml version=\"1.0\"?>" 
+ "«gpx version=\"1.0\" creator=\"GPSLogger - http://gpslogger.mendhak.com/\"" 
+ "xmins:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" " 
+ "xmins=\"http://www.topografix.com/GPX/1/0\" " 
+ "xsi:schemaLocation=\"http://www.topografix.com/GPX/1/0 " 
+ "http:/Awww.topografix.com/GPX/1/0/gpx.xsd\">" 
+ "<time>" + dateTimeString + "</time>" + "«bounds />" + "<trk></trk></gpx>"; 
initialOutput.write(initialXml.getBytes()); 
initialOutput.flush(); 
initialOutput.close(); 
) 
DocumentBuilderFactory factory = DocumentBuilderFactory.newinstance(); 
DocumentBuilder builder = factory.newDocumentBuilder(); 
Document doc = builder.parse(gpxFile); 
Node trkSegNode; 
NodeList trkSegNodeList = doc.getElementsByTagName("trkseg"); 
if(addNewTrackSegment || trkSegNodeList.getLength()==0) 
{ 
NodeList trkNodeList = doc.getElementsByTagName("trk"); 
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trkSegNode = doc.createElement("trkseg"); 
trkNodeList.item(0).appendChild(trkSegNode); 
} 
else 
{ 
trkSegNode = trkSegNodeList.item(trkSegNodeList.getLength()-1); 
} 
Element trkptNode = doc.createElement("trkpt"); 
Attr latAttribute = doc.createAttribute("lat"); 
latAttribute.setValue(String. valueOf(loc.getLatitude())); 
trkptNode.setAttributeNode(latAttribute); 
Attr lonAttribute = doc.createAttribute("lon"); 
lonAttribute.setValue(String.valueOf(loc.getLongitude())); 
trkptNode.setAttributeNode(lonAttribute); 
if(loc.hasAltitude()) 
{ 
Node eleNode = doc.createElement("ele"); 
eleNode.appendChild(doc.create TextNode(String.valueOf(loc.getAltitude()))); 
trkptNode.appendChild(eleNode); 
} 
Node timeNode = doc.createElement("time"); 
timeNode.appendChild(doc.createTextNode(dateTimeString)); 
trkptNode.appendChild(timeNode); 
trkSegNode.appendChild(trkptNode); 
if(loc.hasBearing()) 
{ 
Node courseNode = doc.createElement("course"); 
courseNode.appendChild(doc.create TextNode(String.valueOf(loc.getBearing()))); 
trkptNode.appendChild(courseNode); 
} 
if(loc.hasSpeed()) 
{ 
Node speedNode = doc.createElement("speed"); 
speedNode.appendChild(doc.createTextNode(String. valueOf(loc.getSpeed()))); 
trkptNode.appendChild(speedNode); 
} 
Node srcNode = doc.createElement("src"); 
srcNode.appendChild(doc.create TextNode(loc.getProvider())); 
trkptNode.appendChild(srcNode); 
if(Session.getSatelliteCount() > 0) 
{ 
Node satNode = doc.createElement("sat"); 
satNode.appendChild(doc.create TextNode(String.valueOf(satelliteCount))); 
trkptNode.appendChild(satNode); 
} 
String newFileContents = Utilities. GetStringFromNode(doc); 
synchronized(lock) 
{ 
FileOutputStream fos = new FileOutputStream(gpxFile, false); 
fos.write(newFileContents.getBytes()); 
fos.close(); 
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} 


} 
} 
catch (Exception е) 
{ 
Utilities.LogError("Gpx10FileLogger.Write", e); 
throw new Exception("Could not write to GPX file"); 
} 
} 
public void Annotate(String description) throws Exception 
{ 
if (!gpxFile.exists()) 
{ 


} 
try 
{ 


return; 


DocumentBuilderFactory factory = DocumentBuilderFactory.newlnstance(); 
DocumentBuilder builder = factory.newDocumentBuilder(); 
Document doc = builder.parse(gpxFile); 
NodeList trkptNodeList = doc.getElementsByTagName("trkpt"); 
Node lastTrkPt = trkptNodeList.item(trkptNodeList.getLength()-1); 
Node nameNode = doc.createElement("name"); 
nameNode.appendChild(doc.createTextNode(description)); 
lastTrkPt.appendChild(nameNode); 
Node descNode = doc.createElement("desc"); 
descNode.appendChild(doc.createTextNode(description)); 
lastTrkPt.appendChild(descNode); 
String newFileContents = Utilities.GetStringFromNode(doc); 
synchronized(lock) 
{ 
FileOutputStream fos = new FileOutputStream(gpxFile, false); 
fos.write(newFileContents.getBytes()); 
fos.close(); 
} 
} 
catch(Exception e) 
{ 
Utilities.LogError("Gpx10FileLogger.Annotate", e); 
throw new Exception("Could not annotate GPX file"); 


} 


(2) 编写 文件 Kmll0FileLoggerjava 生成 KML 格式 文件 ， 有 具体 实现 代码 如 下 所 示 。 
class Kml10FileLogger implements IFileLogger 


{ 


@ 


private final static Object lock = new Object(); 

private boolean useSatelliteTime; 

private File kmlFile; 

private FileLock kmlLock; 

Kml1OFileLogger(File kmlFile, boolean useSatellite Time) 
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{ 
this.useSatelliteTime = useSatelliteTime; 
this.kmlFile = kmlFile; 
} 
public void Write(Location loc) throws Exception 
{ 
try 
{ 
Date now; 
if(useSatellite Time) 
{ 
now = new Date(loc.getTime()); 
} 
else 
{ 
now = new Date(); 
} 


String dateTimeString = Utilities. GetlsoDateTime(now); 
if(IkmlFile.exists()) 
{ 
kmlFile.createNewFile(); 
FileOutputStream initialWriter = new FileOutputStream(kmlFile, true); 
BufferedOutputStream initialOutput = new BufferedOutputStream(initialWriter); 
String initialXml = "<?xml version=\"1.0\"?>" 
+ "«kml xmins=\"http://www.opengis.net/kml/2.2\"><Document>" 


+ "<Placemark><LineString><extrude>1</extrude><tessellate>1</tessellate>" 


+ "<altitudeMode>absolute</altitudeMode>" 
+ "<coordinates></coordinates></LineString></Placemark>" 
+ "</Ооситепі></кті>"; 
initialOutput. write(initialXml.getBytes()); 
initialOutput.flush(); 
initialOutput.close(); 
} 
DocumentBuilderFactory factory = DocumentBuilderFactory.newinstance(); 
DocumentBuilder builder = factory.newDocumentBuilder(); 
Document doc = builder.parse(kmlFile); 
NodeList coordinatesList = doc.getElementsByTagName("coordinates"); 
if(coordinatesList.item(0) != null) 
£ 
Node coordinates = coordinatesList.item(0); 
Node coordTextNode = coordinates.getFirstChild(); 
if(coordTextNode == null) 
{ 
coordTextNode = doc.createTextNode(""); 
coordinates.appendChild(coordTextNode); 
} 
String coordText = coordinates.getFirstChild().getNodeValue(); 
coordText = coordText + "in" + String.valueOf(loc.getLongitude()) + "," 


+ String.valueOf(loc.getLatitude()) + "," + String.valueOf(loc.getAltitude()); 


coordinates.removeChild(coordinates.getFirstChild()); 
coordinates.appendChild(doc.createTextNode(coordText)); 
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@ 


) 


) 
Node documentNode = doc.getElementsByTagName("Document").item(0); 


Node newPlacemark = doc.createElement("Placemark"); 
Node timeStamp = doc.createElement("TimeStamp"); 
Node whenNode = doc.createElement("when"); 
Node whenNodeText = doc.createTextNode(dateTimeString); 
whenNode.appendChild(whenNodeText); 
timeStamp.appendChild(whenNode); 
newPlacemark.appendChild(timeStamp); 
Node newPoint = doc.createElement("Point"); 
Node newCoords = doc.createElement("coordinates"); 
newCoords.appendChild(doc.create TextNode(String.valueOf(loc.getLongitude()) + "," 
+ String.valueOf(loc.getLatitude()) + "," + String.valueOf(loc.getAltitude()))); 
newPoint.appendChild(newCoords); 
newPlacemark.appendChild(newPoint); 
documentNode.appendChild(newPlacemark); 
String newFileContents = Utilities.GetStringFromNode(doc); 
synchronized(lock) 
{ 
FileOutputStream fos = new FileOutputStream(kmlFile, false); 
fos.write(newFileContents.getBytes()); 
fos.close(); 


} 


catch(Exception e) 


{ 


} 
} 


Utilities.LogError("Kml10FileLogger.Write", e); 
throw new Exception("Could not write to KML file"); 


public void Annotate(String description) throws Exception 


{ 


if(!kmlFile.exists()) 


{ 


} 
try 
{ 


return; 


DocumentBuilderFactory factory = DocumentBuilderFactory.newlInstance(); 
DocumentBuilder builder = factory.newDocumentBuilder(); 
Document doc = builder.parse(kmlFile); 
NodeList placemarkList = doc.getElementsByTagName("Placemark"); 
Node lastPlacemark = placemarkList.item(placemarkList.getLength() - 1); 
Node annotation = doc.createElement("name"); 
annotation.appendChild(doc.create TextNode(description)); 
lastPlacemark.appendChild(annotation); 
String newFileContents - Utilities.GetStringFromNode(doc); 
synchronized(lock) 
{ 
FileOutputStream fos = new FileOutputStream(kmiFile, false); 
fos.write(newFileContents.getBytes()); 
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fos.close(); 


} 


catch(Exception e) 

{ 
Utilities.LogError("Kml10FileLogger.Annotate", e); 
throw new Exception("Could not annotate KML file"); 


94 邮件 分 享 提醒 


GED 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 9 章 \ 邮 件 分 享 提醒 .avi 
在 系统 设置 模块 中 ， 可 以 设置 系统 邮件 来 分 享 行走 轨迹 信息 。 其 中 邮件 分 享 提醒 界面 如 图 9-6 所 示 。 


Enable auto send 


Target email address 
How often? 


Mail Provider 
Username 


Password 


图 9-6 邮件 分 享 提醒 界面 
9.4.1 基本 邮箱 设置 


编写 文件 AutoEmailActivityjava， 功 能 是 设置 发 送 邮件 的 邮箱 地 址 、 密 码 、 邮 件 服务 器 等 信息 ， 这 
样 可 以 在 使 用 时 实现 邮件 自动 发 送 功能 。 文 件 AutoEmailActivityjava 的 具体 实现 代码 如 下 所 示 。 
public class AutoEmailActivity extends PreferenceActivity implements 


OnPreferenceChangeListener, IMessageBoxCallback, IAutoSendHelper, 
OnPreferenceClickListener 


{ 
private final Handler handler = new Handler(); 
@Override 
public void onCreate(Bundle savedinstanceState) 
{ 


super.onCreate(savedinstanceState); 
addPreferencesFromResource(R.xml.autoemailsettings); 


к 
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} 


CheckBoxPreference chkEnabled = (CheckBoxPreference) findPreference("autoemail_enabled"); 
chkEnabled.setOnPreferenceChangeListener(this); 

ListPreference IstPresets = (ListPreference) findPreference("autoemail preset"); 
IstPresets.setOnPreferenceChangeListener(this); 

EditTextPreference txtSmtpServer = (EditTextPreference) findPreference("smtp server"); 
EditTextPreference txtSmtpPort = (EditTextPreference) findPreference("smtp port"); 
txtSmtpServer.setOnPreferenceChangeListener(this); 

txtSmtpP ort.setOnPreferenceChangeListener(this); 

Preference testEmailPref = (Preference) findPreference("smtp testemail"); 
testEmailPref.setOnPreferenceClickListener(this); 


public boolean onPreferenceClick(Preference preference) 


{ 


} 


if (IIsFormValid()) 


{ 

Utilities. MsgBox(getString(R.string.autoemail invalid form), 
getString(R.string.autoemail_invalid_form_message), 
AutoEmailActivity.this); 

return false; 

} 


Utilities. ShowProgress(this, getString(R.string.autoemail_sendingtest), 
getString(R.string.please_wait)); 

CheckBoxPreference chkUseSsl = (CheckBoxPreference) findPreference("smtp. ssl"); 
EditTextPreference txtSmtpServer = (EditTextPreference) findPreference("smtp server"); 
EditTextPreference txtSmtpPort 7 (EditTextPreference) findPreference("smtp port"); 
EditTextPreference txtUsername = (EditTextPreference) findPreference("smtp username"); 
EditTextPreference txtPassword = (EditTextPreference) findPreference("smtp password"); 
EditTextPreference txtTarget = (EditTextPreference) findPreference("autoemail target"); 
AutoEmailHelper aeh = new AutoEmailHelper(null); 
aeh.SendTestEmail(txtSmtpServer.getText(), txtSmtpPort.getText(), 

txtUsername.getText(), txtPassword.getText(), 

chkUseSsl.isChecked(), txtTarget.getText(), 

AutoEmailActivity.this, AutoEmailActivity.this); 

return true; 


private boolean IsFormValid() 


{ 


CheckBoxPreference chkEnabled = (CheckBoxPreference) findPreference("autoemail_enabled"); 
EditTextPreference txtSmtpServer = (EditTextPreference) findPreference("smtp server"); 
EditTextPreference txtSmtpPort = (EditTextPreference) findPreference("smtp_port"); 
EditTextPreference txtUsername = (EditTextPreference) findPreference("smtp username"); 
EditTextPreference txtPassword = (EditTextPreference) findPreference("smtp_password"); 
EditTextPreference txtTarget = (EditTextPreference) findPreference("autoemail target"); 
if (chkEnabled.isChecked()) 
{ 
if (txtSmtpServer.getText() != null 

&& txtSmtpServer.getText().length() > 0 

&& txtSmtpPort.getText() != null 

&& txtSmtpPort.getText().length() > 0 

&& txtUsername.getText() != null 

&& txtUsername.getText().length() > 0 
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&& txtPassword.getText() != null 

&& txtPassword.getText().length() > 0 
&& txtTarget.getText() != null 

&& txtTarget.getText().length() > 0) 


{ 
return true; 
} 
else 
{ 
return false; 
} 
} 
return true; 
} 
public boolean onKeyDown(int keyCode, KeyEvent event) 
{ 
if (keyCode == KeyEvent.KEYCODE_BACK) 
{ 
if (!lsFormValid()) 
( 
Utilities.MsgBox(getString(R.string.autoemail invalid form), 
getString(R.string.autoemail invalid form message), 
this); 
return false; 
} 
else 
{ 
return super.onKeyDown(keyCode, event); 
} 
} 
else 
{ 
return super.onKeyDown(keyCode, event); 
} 
} 
public void MessageBoxResult(int which) 
{ 
finish(); 
} 
public boolean onPreferenceChange(Preference preference, Object newValue) 
{ 
if (preference.getKey().equals("autoemail_preset")) 
{ 
int newPreset = Integer.valueOf(newValue.toString()); 
switch (newPreset) 
{ 
case 0: 
1 Gmail 
SetSmtpValues("smtp.gmail.com", "465", true); 
break; 
case 1: 
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11 Windows live mail 
SetSmtpValues("smtp.live.com", "587", false); 


break; 
case 2: 
11 Yahoo 
SetSmtpValues("smtp.mail.yahoo.com", "465", true); 
break; 
case 99: 
11 manual 
break; 
} 
} 
return true; 
} 
private void SetSmtpValues(String server, String port, boolean useSsl) 
{ 
SharedPreferences prefs = PreferenceManager 
.getDefaultSharedPreferences(getBaseContext()); 
SharedPreferences.Editor editor = prefs.edit(); 
EditTextPreference txtSmtpServer = (EditTextPreference) findPreference("smtp server"); 
EditTextPreference txtSmtpPort = (EditTextPreference) findPreference("smtp port"); 
CheckBoxPreference chkUseSsl = (CheckBoxPreference) findPreference("smtp ssl"); 
11 Yahoo 
txtSmtpServer.setText(server); 
editor.putString("smtp server", server); 
txtSmtpPort.setText(port); 
editor.putString("smtp port", port); 
chkUseSsl.setChecked(useSsl); 
editor.putBoolean("smtp ssl", useSsl); 
editor.commit(); 
) 


String — testResults; 
public void OnRelay(boolean connectionSuccess, String message) 


{ 
testResults = message; 
handler.post(showTestResults); 
} 
private final Runnable showTestResults = new Runnable() 
{ 
public void run() 
{ 
TestEmailResults(); 
} 
} 
private void TestEmailResults() 
{ 
Utilities.HideProgress(); 
Utilities.MsgBox(getString(R.string.autoemail_testresult_title), 
testResults, this); 
} 
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9.4.2 ”实现 邮件 发 送 功能 


编写 文件 AutoEmailHelperjava， 功 能 是 使 用 邮件 设置 模块 的 邮箱 来 发 送 邮件 信息 ， 有 具体 实 现代 码 


如 下 所 示 。 
public class AutoEmailHelper implements IAutoSendHelper 


{ 


} 


private GpsLoggingService mainActivity; 


private boolean forcedSend = false; 
public AutoEmailHelper(GpsLoggingService activity) 
{ 
this.mainActivity = activity; 
} 
public void SendLogFile(String currentFileName, boolean forcedSend) 
{ 
this.forcedSend = forcedSend; 
Thread t = new Thread(new AutoSendHandler(currentFileName, this)); 
t.start(); 
} 


void SendTestEmail(String smtpServer, String smtpPort, 
String smtpUsername, String smtpPassword, boolean smtpUseSsl, 
String emailTarget, Activity callingActivity, IAutoSendHelper helper) 


{ 
Thread t = new Thread(new TestEmailHandler(helper, smtpServer, 
smtpPort, smtpUsername, smtpPassword, smtpUseSsl, emailTarget)); 
t.start(); 
} 
public void OnRelay(boolean connectionSuccess, String errorMessage) 
{ 
if (IconnectionSuccess) 
{ 
mainActivity.handler.post(mainActivity.updateResultsEmailSendError); 
} 
else 
{ 
II This was a success 
Utilities.LogInfo("Email sent"); 
if (!forcedSend) 
{ 
Utilities.LogDebug("setEmailReadyToBeSent = false"); 
Session.setEmailReadyToBeSent(false); 
} 
} 
} 


class AutoSendHandler implements Runnable 


{ 


private String currentFileName; 
private [AutoSendHelper helper; 
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public AutoSendHandler(String currentFileName, ^ lAutoSendHelper helper) 


{ 
this.currentFileName = currentFileName; 
this.helper = helper; 
} 
public void run() 
{ 
File gpxFolder = new File(Environment.getExternalStorageDirectory(), 
"GPSLogger"); 
if (IgpxFolder.exists()) 
{ 
helper.OnRelay(true, null); 
return; 
} 


File gpxFile = new File(gpxFolder.getPath(), currentFileName + ".gpx"); 
File kmlFile = new File(gpxFolder.getPath(), currentFileName + ".kml"); 
File foundFile = null; 

if (kmlFile.exists()) 


{ 
foundFile = kmlFile; 
} 
if (gpxFile.exists()) 
{ 
foundFile = gpxFile; 
} 
if (foundFile == null) 
{ 
helper.OnRelay(true, null); 
return; 
} 


String[ ] files = new String[ ] 
{ foundFile.getAbsolutePath() ); 
File zipFile = new File(gpxFolder.getPath(), currentFileName + ".zip"); 


try 

{ 
Utilities. Loginfo("Zipping file"); 
ZipHelper zh = new ZipHelper(files, zipFile.getAbsolutePath()); 
zh.Zip(); 


Mail m = new Mail(AppSettings.getSmtpUsername(), 
AppSettings.getSmtpPassword()); 
String[ ] toArr = 
{ AppSettings.getAutoEmailTarget() }; 
m.setTo(toArr); 
m.setFrom(AppSettings.getSmtpUsemame()); 
m.setSubject("GPS Log file generated at" 
+ Utilities.GetReadableDateTime(new Date()) + " - " 
+ zipFile.getName()); 
m.setBody(zipFile.getName()); 
m.setPort(AppSettings.getSmtpPort()); 
m.setSecurePort(AppSettings.getSmtpPort()); 
m.setSmtpHost(AppSettings.getSmtpServer()); 


} 
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m.setSsl(AppSettings.isSmtpSsl()); 
m.addAttachment(zipFile.getAbsolutePath()); 
Utilities.LogInfo("Sending email..."); 


if (m.send()) 
{ 
helper.OnRelay(true, "Email was sent successfully."); 
} 
else 
{ 
helper.OnRelay(false, "Email was not sent."); 
} 
} 
catch (Exception e) 
{ 
helper.OnRelay(false, e.getMessage()); 
Utilities. LogError("AutoSendHandler.run", e); 
} 


class TestEmailHandler implements Runnable 


{ 


String smtpServer; 
String smtpPort; 
String smtpUsername; 
String smtpPassword; 
boolean smtpUseSsl; 
String emailTarget; 


lAutoSendHelper helper; 

public TestEmailHandler(lAutoSendHelper helper, String smtpServer, 
String smtpPort, String smtpUsername, String smtpPassword, 
boolean smtpUseSsl, String emailTarget) 


this.smtpServer = smtpServer; 
this.smtpPort = smtpPort; 
this.smtpPassword 7 smtpPassword; 
this.smtpUsername = smtpUsername; 
this.smtpUseSsl = smtpUseSsl; 
this.emailTarget = emailTarget; 
this.helper = helper; 
) 
public void run() 
{ 
try 
{ 
Mail m = new Mail(smtpUsername, smtpPassword); 
String[ ] toArr = 
{ emailTarget }; 
m.setTo(toArr); 
m.setFrom(smtpUsemame); 
m.setSubject("Test Email from GPSLogger at " 
+ Utilities.GetReadableDateTime(new Date())); 
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m.setBody("Test Email from GPSLogger at" 


+ Utilities.GetReadableDateTime(new Date())); 


m.setPort(smtpPort); 
m.setSecurePort(smtpPort); 
m.setSmtpHost(smtpServer); 
m.setSsl(smtpUseSsl); 
m.setDebuggable(true); 
Utilities.LogInfo("Sending email..."); 
if (m.send()) 

{ 


} 


езе 


} 


helper.OnRelay(true, "Email was sent successfully."); 


helper.OnRelay(false, "Email was not sent."); 


} 
catch (Exception e) 


{ 


helper.OnRelay(false, e.getMessage()); 
Utilities. LogError("AutoSendHandler.run", e); 


9.5 上 传 OSM 地 图 


ШИ 知识 点 讲解 ， 光盘 :视频 \ 知 识 点 \ 第 9 章 \ 上 传 OSM 地 图 .avi 
OSM 是 OpenStreetMap 的 简称 ， 这 是 一 个 网 上 地 图 协作 计划 ， 目 的 是 创造 一 个 内 容 自由 且 能 让 所 
有 人 编辑 的 世界 地 图 。OSM 的 地 图 由 用 户 根据 手提 GPS 装置 、 航 空 摄影 照片 、 其 他 自由 内 容 甚 至 单 靠 


本 地 知识 绘制 。 网 站 里 的 地 图 图 像 矢 量 数据 皆 以 共享 创意 姓名 表示 ， 用 
网 站 的 灵感 来 自 维基 百科 等 网 站 ， 经 注册 的 用 户 可 上 传 GPS 路 径 及 使 有 


相同 方式 分 享 2.0 授权 。OSM 


日 内 置 的 编辑 程式 编辑 数据 。 在 


上 传 地 图 信息 之 前 ， 需 要 先 获 得 授权 标识 。 当 单 击 OpenStreetMap Preferences 按钮 后 会 来 到 授权 提示 界 
面 ， 在 此 界面 会 显示 授权 提示 信息 ， 如 图 9-7 所 示 。 


9-7 授权 提示 


9.5.1 授权 提示 布局 文件 


授权 提示 界面 的 布 


@ 


局 文件 是 osmauth.xml， 具 体 实现 代码 如 下 所 示 。 
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<LinearLayout 
xmins:android="http://schemas.android.com/apk/res/android" 
android:layout_width="fill_parent" 
android:layout_height="fill_parent"> 
<TableLayout androi "()*id/TableOSM" 
android:layout width-"fill parent" android:layout height-"wrap content" 
android:stretchColumns="1" android:background="#000000"> 
<TableRow></TableRow> 
<TableRow> 
<TextView android:id="@+id/lblAuthorizeDescription" android:layout height-"wrap content" 
android:text-"(Qstringlosm Ibl authorize description" android:layout width-"wrap content"»«/TextView» 
</TableRow> 
<TableRow> 
«Button android:id="@+id/btnAuthorizeOSM" 
android:text-"(string/osm Ibl authorize" android:layout_height="wrap_content" android:layout_ 
width-"wrap content"/» 
</TableRow> 
</TableLayout> 
</LinearLayout> 


通过 上 述 代 码 在 屏幕 中 显示 授权 提示 信息 ， 并 在 屏幕 下 方 显示 了 一 个 激活 按钮 。 当 单 击 激活 按钮 
后 会 触发 文件 OSMAuthorizationActivityjava， 有 具体 实现 代码 如 下 所 示 。 
public class OSMAuthorizationActivity extends Activity implements 
OnClickListener 


{ 
private static OAuthProvider provider; 
private static OAuthConsumer consumer; 
@Override 
public void onCreate(Bundle savedlnstanceState) 
{ 
super.onCreate(savedinstanceState); 
setContentView(R.layout.osmauth); 
final Intent intent = getIntent(); 
final Uri myURI = intent.getData(); 
if (myURI != null && myURI.getQuery() != null 
&& myURI.getQuery().length() > 0) 
{ 
//User has returned! Read the verifier info from querystring 
String oAuthVerifier = myURI.getQueryParameter("oauth_verifier"); 
try 


{ 
SharedPreferences prefs = PreferenceManager.getDefaultSharedPreferences(getBaseContext()); 


if (provider == null) 


{ 
provider = Utilities.GetOSMAuthProvider(getBaseContext()); 
} 
if (consumer == null) 
{ 


п case consumer is null, re-initialize from stored values. 
consumer = Utilities. GetOSMAuthConsumer(getBaseContext()); 
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} 
//Ask OpenStreetMap for the access token. This is the main event. 
provider.retrieveAccess Token(consumer, oAuthVerifier); 


String osmAccess Token = consumer.getToken(); 
String osmAccessTokenSecret = consumer.getTokenSecret(); 


//Save for use later. 

SharedPreferences.Editor editor = prefs.edit(); 
editor.putString("osm_accesstoken", osmAccess Token); 
editor.putString("osm_accesstokensecret", osmAccessTokenSecret); 


editor.commit(); 
/INow go away 
startActivity(new Intent(getBaseContext(), GpsMainActivity.class)); 
finish(); 
) 
catch (Exception e) 
{ 
Utilities.LogError("OSMAuthorizationActivity.onCreate - user has returned", е); 
Utilities. MsgBox(getString(R.string.sorry), getString(R.string.osm_auth_error), this); 
} 


} 
Button authButton = (Button) findViewByld(R.id.btnAuthorizeOSM); 
authButton.setOnClickListener(this); 


} 
public void onClick(View v) 
{ 

try 

{ 


//User clicks. Set the consumer and provider up. 

consumer = Utilities. GetOSMAuthConsumer(getBaseContext()); 

provider = Utilities.GetOSMAuthProvider(getBaseContext()); 

String authUrl; 

//Get the request token and request token secret 

authUr = provider.retrieveRequestToken(consumer, OAuth.OUT OF BAND); 
//Save for later 

SharedPreferences prefs = PreferenceManager.getDefaultSharedPreferences(getBaseContext()); 
SharedPreferences.Editor editor = prefs.edit(); 
editor.putString("osm_requesttoken", consumer.getToken()); 
editor.putString("osm_requesttokensecret",consumer.getTokenSecret()); 
editor.commit(); 

//Open browser, send user to OpenStreetMap.org 

Uri uri = Uri.parse(authUrl); 

Intent intent = new Intent(Intent ACTION_VIEW, uri); 


startActivity(intent); 
} 
catch (Exception e) 
{ 


Utilities .LogError("OSMAuthorizationActivity.onClick", е); 
Utilities. MsgBox(getString(R.string.sorry), getString(R.string.osm_auth_error), this); 


@ 
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9.5.2 ”实现 文件 上 传 


编写 文件 OSMHelperjava， 功 能 是 在 获取 权限 后 上 传 OpenStreetMap 轨迹 文件 ， 具 体 实现 代码 如 
下 所 示 。 


public class OSMHelper implements IOsmHelper 
{ 
private GpsMainActivity mainActivity; 
public OSMHelper(GpsMainActivity activity) 
{ 


} 


this.mainActivity = activity; 


public void UploadGpsTrace(String fileName) 
{ 
File gpxFolder = new File(Environment.getExternalStorageDirectory(), "BPSLogger"); 
File chosenFile = new File(gpxFolder, fileName); 
OAuthConsumer consumer = Utilities. GetOSMAuthConsumer(mainActivity.getBaseC ontext()); 
String gps TraceUrl = mainActivity.getString(R.string.osm gpstrace url); 


SharedPreferences prefs = PreferenceManager.getDefaultSharedPreferences(mainActivity.getBaseContext()); 
String description = prefs.getString("osm_description", ""); 

String tags = prefs.getString("osm_tags", ""); 

String visibility = prefs.getString("osm visibility", "private"); 


Thread t = new Thread(new OsmUploadHandler(this, consumer, gpsTraceUrl, chosenFile, description, 
tags, visibility); 


t.start(); 
) 
public void OnComplete() 
{ 
mainActivity.handler.post(mainActivity.updateOsmUpload); 
} 
private class OsmUploadHandler implements Runnable 
{ 
OAuthConsumer consumer; 
String gps TraceUrl; 
File chosenFile; 
String description; 
String tags; 
String visibility; 
IOsmHelper helper; 


public OsmUploadHandler(IOsmHelper helper, OAuthConsumer consumer, String gpsTraceUrl, File 
chosenFile, String description, String tags, String visibility) 
{ 


this.consumer = consumer; 
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this.gpsTraceUrl = gpsTraceUrl; 
this.chosenFile = chosenFile; 
this.description = description; 
this.tags = tags; 
this.visibility = visibility; 
this.helper = helper; 

} 


public void run() 
{ 
try 


{ 
HttpPost request = new HttpPost(gps TraceUrl); 


consumer.sign(request); 
MultipartEntity entity = new MultipartEntity(HttpMultipartMode.BROWSER COMPATIBLE); 


FileBody gpxBody = new FileBody(chosenFile); 
entity.addPart("file", gpxBody); 
if(description == null || description.length() <= 0) 
{ 

description = "GPSLogger for Android"; 
} 


entity.addPart("description", new StringBody(description)); 
entity.addPart("tags", new StringBody(tags)); 
entity.addPart(" visibility", new StringBody(visibility)); 


request.setEntity (entity); 

DefaultHttpClient httpClient = new DefaultHttpClient(); 
HttpResponse response = httpClient.execute(request); 

int statusCode = response.getStatusLine().getStatusCode(); 
Utilities.LogDebug("OSM Upload - " * String.valueOf(statusCode)); 
helper.OnComplete(); 


} 
catch(Exception e) 
{ 
Utilities.LogError("OsmUploadHelper.run", е); 
} 


} 


} 
interface |OsmHelper 


{ 
public void OnComplete(); 


} 
到 此 为 止 ， 本 章 实例 的 主要 模块 介绍 完毕 。 为 了 节省 本 书 的 篇 幅 ， 有 关 本 实例 其 余 模块 的 具体 实 
现 过 程 ， 请 读者 参阅 本 书 附带 光盘 的 内 容 。 
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智能 家 居 是 一 个 居住 环境 ， 又 称 智能 住宅 。 通 俗 地 说 ， 它 是 融合 了 自动 化 控制 系统 、 计 算 机 网 络 
系统 、 无 限 传 感 网 络 系统 和 网 络 通信 技术 于 一 体 的 网 络 化、 智能 化 的 家 居 控 制 系统 。 本 章 将 通过 一 个 
综合 实例 的 实现 过 程 ， 详 细 讲 解 在 Android 系统 中 开发 一 个 智能 家 居 系 统 的 方法 。 


10.1 需求 分 析 


Юй 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 10 章 \ 需 求 分 析 .avi 

智能 家 居 将 让 用 户 以 更 便捷 的 方式 来 管理 家 庭 设备 ， 比 如 ， 通 过 触摸 屏 、 无 线 遥 控 器 、 电 话 、 互 
联网 或 者 语音 识别 控制 家 用 设备 ， 更 可 以 执行 场景 操作 ， 使 多 个 设备 形成 联动 另外， 智能 家 居 内 的 
各 种 设备 相互 间 可 以 通信 ， 不 需要 用 户 指挥 也 能 根据 不 同 的 状态 互动 运行 ， 从 而 给 用 户 带 来 最 大 程度 
的 高 效 、 便 利 、 舒 适 与 安全 。 在 本 节 的 内 容 中 ， 将 详细 讲解 本 系统 的 需求 分 析 。 


10.1.1 背景 介绍 


家 居 智 能 化 在 我 国 的 应 用 已 经 有 一 段 时 间 了 , 但 是 目前 大 多 数 的 智能 家 居 系 统 仍然 只 适用 于 别墅 、 
洋房 、 公 寓 等 高 级 住房 。 而 移动 电话 的 应 用 在 我 国 却 非常 普及 ， 所 以 手机 智能 家 居 系 统 软件 将 成 为 智 
能 家 居 系 统 中 的 主流 产品 。 

对 于 智能 家 居 产 品 ， 第 一 印象 便 是 便捷 ， 通 过 一 个 小 小 的 手机 ， 便 可 随时 掌握 、 控 制 家 里 的 所 有 
常用 家 电 设 备 ， 包 括 : 灯光 、 窗 帘 、 电 器 、 空 调和 地 上 暖 等 ， 甚 至 天 气 预 报 ， 室 内 温 湿 度 显示 等 ， 成 为 
未 来 理想 智能 家 居 的 必需 品 。 随 着 各 种 基于 ЗС 和 WiFi 功能 的 智能 产品 逐步 应 用 于 人 们 的 生活 中 ， 方 
便 直观 触摸 操作 的 移动 触摸 智能 控制 终端 诸如 Android. iPhone. iPad 等 ， 必 将 成 为 智能 家 居 未 来 的 发 
展 趋势 。 传 统 的 智能 家 居 系 统 包含 的 主要 子 系统 有 : 家 居 布 线 系统 、 家 庭 网 络 系 统 、 智 能 家 居 (中 央 ) 
控制 管理 系统 、 家 居 照 明 控制 系统 、 家 庭 安防 系统 、 背 景 音乐 系统 、 家 庭 影 院 与 多 媒体 系统 、 家 庭 环 
境 控制 系统 等 8 大 系统 。 其 中 ， 智 能 家 居 (中 央 ) 控制 管理 系统 、 家 居 照 明 控制 系统 、 家 庭 安防 系统 
是 必 备 系统 ， 家 居 布 线 系统 、 家 庭 网 络 系统 、 背 景 音乐 系统 、 家 庭 影院 与 多 媒体 系统 、 家 庭 环 境 控制 
系统 为 可 选 系统 。 

通常 会 认为 智能 家 居 会 带 来 生活 品质 的 提升 ， 其 实物 联网 智能 家 居 正 在 改变 这 些 观点 ， 最 显著 的 
变化 就 是 实用 、 方 便 、 易 整合 。 每 一 个 家 庭 中 都 存在 各 种 电器 ， 不 管 是 号 称 智 能 的 冰箱 、 空 调 还 是 传 
统 的 电灯 、 电 视 ， 一 直 以 来 由 于 标准 不 一 都 是 独立 工作 的 ， 从 系统 的 角度 来 看 ， 它 们 都 是 零碎 的 、 混 
乱 的 、 无 序 的， 并 不 是 一 个 有 机 的 、 可 组 织 的 整体 ， 这 些 杂 乱 无 章 的 电器 所 消耗 的 时 间 成 本 、 管 理 成 
本 、 控 制 成 本 通常 都 是 很 高 的 ， 作 为 家 庭 的 主人 对 其 进行 智能 化 管理 非常 必要 。 
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传感器 技术 是 近年 来 在 科技 界 兴起 的 一 大 热点 ， 这 项 技术 是 全 球 第 一 个 利用 物 联网 来 控制 灯饰 及 
电子 电器 产品 (ZigBee 标准 产品 )， 并 将 其 作为 智能 家 居 主流 产品 走向 了 商业 化 。ZigBee 最 初 预计 的 
应 用 领域 主要 包括 消费 电子 、 能 源 管理 、 卫 生 保健 、 家 庭 自动 化 、 建 筑 自动 化 和 工业 自动 化 。 随 着 物 
联网 的 兴起 ，ZigBee 又 获得 了 新 的 应 用 机 会 。 物 联网 的 网 络 边缘 应 用 最 多 的 就 是 传感器 或 控制 单元 ， 
这 些 是 构成 物 联网 最 基础 、 最 核心 、 最 广泛 的 单元 ， 而 ZigBee 能 够 在 数 千 个 微小 的 传 感 传 动 单元 之 间 
相互 协调 实现 通信 ， 并 且 这 些 单元 只 需要 很 少 的 能 量 ， 以 接力 的 方式 通过 无 线 电波 将 数据 从 一 个 网 络 
节点 传 到 另 一 个 节点 ， 所 以 它 的 通信 效率 非常 高 。 这 种 技术 低 功 耗 、 抗 干扰 、 高 可 靠 、 易 组 网 、 易 扩 
容 、 易 使 用 、 易 维护 、 便 于 快速 大 规模 部 署 等 特点 顺应 了 物 联网 发 展 的 要 求 和 趋势 。 目 前 来 看 ， 物 联 
网 和 ZigBee 技术 在 智能 家 居 、 工 业 监测 和 健康 保健 等 方面 的 应 用 有 很 大 的 融合 性 。 

值得 注意 的 是 ， 物 联网 的 兴起 将 会 给 ZigBee 带 来 广阔 的 市 场 空间 。 因 为 物 联网 的 目的 是 要 将 各 种 
信息 传 感 传动 单元 与 互联 网 结合 起 来 从 而 形成 一 个 巨大 的 网 络 ， 在 这 个 巨大 网 络 中 ， 传 感 传动 单元 与 
通信 网 络 之 问 需要 数据 的 传输 ， 而 相对 其 他 无 线 技术 而 言 ，ZigBee 以 其 在 投资 、 建 设 、 维 护 等 方面 的 
优势 ， 必 将 在 物 联 网 型 智能 家 居 领 域 获得 更 广泛 的 应 用 。 物 联 传 感 控制 规格 遂 成 为 当今 家 庭 智 能 家 居 
自动 化 控制 规格 的 主要 领导 者 。 


10.1.3 Android 与 智能 家 居 的 紧密 联系 


2011 年 5 月 10 H, Google 在 Moscone West 会 议 中 心 举行 的 Google IO 大 会 上 首次 宣布 了 Android@Home 
计划 。 究 竟 什 么 是 Android@Home? 就 是 通过 Android 设备 来 完全 控制 例如 台灯 、 闹 钟 、 洗 碗 机 等 家 
电 产 品 ， 实 现 居住 环境 的 完全 Android 化 。 

在 2011 年 举办 的 谷歌 VO 大 会 展示 当中 ， 谷 歌 为 我 们 演示 了 通过 摩托 罗拉 XOOM 平板 上 对 4 6 
台灯 进行 控制 。 用 户 只 需 对 平板 上 的 4 个 开关 进行 虚拟 化 操作 ， 对 应 的 台灯 就 会 立马 作出 相应 反应 。 
下 一 个 例子 ， 谷 歌 向 我 们 展示 了 唤醒 懒 人 的 好 方法 : 通过 Android@Home 连接 在 一 起 的 闹 铃 系统 。 每 
当 亲 铃 响 起 之 际 ， 家 中 音响 的 音量 、 灯 光 的 亮度 也 会 随 之 递增 ， 面 对 如 此 先进 的 闹 铃 系统 ， 相 信 再 能 
睡 的 人 也 会 被 其 准时 唤醒 。 

现在 ，Android@Home 计划 又 有 了 新 的 进展 ， 正 在 有 计划 建立 一 个 连接 家 中 所 有 Android 设备 的 
云端 自动 化 平台 。 因 为 后 PC 时 代 的 一 部 分 组 成 是 云 , 所 以 Google 正在 努力 地 成 为 一 个 云 服务 提供 商 。 
随 着 Google 对 Android@Home 计划 的 投入 , 越 来 越 多 的 新 技术 会 被 应 用 到 智能 家 居中 ,这 也 将 引爆 新 
一 轮 的 智能 家 居 创 新 热潮 。 


10.2 系统 功能 模块 介绍 


и 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 10 章 \ 系 统 功能 模块 介绍 .avi 

本 章 智 能 家 居 系 统 的 功能 是 , 在 Android 系统 中 开发 一 个 智能 家 居 系 统 客户 端 App, 通过 这 个 App 
可 以 实现 照明 控制 、 温 度 控制 、 查 看 天 气 和 系统 设置 功能 。 本 章 智能 家 居 系 统 的 构成 模块 结构 如 图 10-1 
所 示 。 
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103 系统 主 界面 


GH 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 10 章 \ 系 统 主 界面 .avi 
系统 主 界面 是 运行 程序 后 首先 呈现 在 用 户 面 前 的 界面 。 在 本 节 的 内 容 中 ， 将 详细 讲解 实现 本 章 知 
能 家 居 系 统 主 界面 的 具体 流程 。 


10.3.4 ”实现 布局 文件 


通过 分 析 AndroidManifest.xml 清单 文件 可 知 ， 本 系统 主 界面 的 布局 文件 是 main.xml， 功 能 是 通过 


GridView 控件 显示 系统 控制 选项 。 文 件 main.xml 的 具体 实现 代码 如 下 所 示 。 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout widthz"fill parent" 
android:layout height-"fill parent" 
> 
<TextView 
android:layout_width="fill_ parent" 
android:layout_height="wrap_content" 
android:text="@string/hello" 
> 


«GridView xmins:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/gridview" 

android:layout_width="fill_ parent" 

android:layout height-"fill parent" 

android:numColumns-"auto fit" 


Android kB TER Sc 


android:verticalSpacing-"1 0dp" 
android:horizontalSpacing="10.dp" 
android:columnWidth="90dp" 
android:stretchMode="columnWidth" 
android:gravity="center" 


</LinearLayout> 


10.3.2 ”实现 程序 文件 


n 
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系统 主 界面 的 程序 文件 是 ClientStartjava， 功 能 是 加 载 布局 文件 main.xml， 然 后 在 GridView 控件 
和 显示 系统 控制 选项 : 温度、 电器 控制 、 预 案 管理 。 文 件 ClientStartjava 的 具体 实现 代码 如 下 所 示 。 
public class ClientStart extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate(Bundle savedinstanceState) { 


super.onCreate(savedinstanceState); 
setContentView(R.layout.main); 
GridView gridView=(GridView)findViewByld(R.id.gridview); 
ArrayList<HashMap<String, Object»? Istlmageltem- 

new ArrayList<HashMap<String, Object>>(); 


HashMap<String, Object» map0=new HashMap<String, Object>(); 
map0.put("Image", R.drawable.app_icon); 

map0.put("Text", "温度 "); 

IstImageltem.add(map0); 


HashMap<String, Object» map1=new HashMap<String, Object>(); 
map1.put("Image", R.drawable.sln); 

map1.put("Text", "电器 控制 "); 

Istimageltem.add(map1); 


HashMap<String, Object» map2-new HashMap<String, Object>(); 
map2.put("Image", R.drawable.open); 

map2.put("Text", "预案 管理 "); 

IstlImageltem.add(map2); 


HashMap<String, Object? map3=new HashMap<String, Object>(); 
map3.put("Image", R.drawable.close); 

map3.put("Text", "4"); 

Istimageltem.add(map2); 


SimpleAdapter salmageltems-new SimpleAdapter(this,|stimageltem,R.layoutfunction,new String[ "Image", 


"Text", new int[ }{R.id.ltemlmage, R.id.ltemText}); 


gridView.setAdapter(salmageltems); 


gridView.setOnltemClickListener(new ItemClickListener()); 
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} 
class ItemClickListener implements OnltemClickListener{ 
public void onltemClick(AdapterView<?> arg0,View arg1,int arg2,long arg3) 
{ 

Intent intent; 

switch (arg2) 

{ 

case 0: 
intent= new Intent (ClientStart.this, SystemSet.class); 
startActivity(intent); 
break; 

case 1: 
intent = new Intent (ClientStart.this, DeviceControl.class); 
startActivity(intent); 
break; 

case 2: 
intent = new Intent (ClientStart.this, Weather01.class); 
startActivity(intent); 
break; 

case 3: 
break; 
default: 
break; 


} 
} 
系统 主 界面 的 执行 效果 如 图 10-2 所 示 。 


图 10-2 系统 主 界面 


10.4 系统 设置 


知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 10 章 \ 系 统 设置 .avi 

系统 设置 模块 的 功能 是 设置 当前 使 用 者 的 系统 信息 ， 主 要 包括 服务 器 电话 、 控 制 方式 、 短 信服 务 、 
城市 名 称 、 更 新 频率 、 开 启 预案 、 服 务 器 地 址 和 端口 信息 等 。 在 本 节 的 内 容 中 ， 将 详细 讲解 实现 本 章 
系统 设置 模块 的 具体 流程 。 
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10.4.1 总 体 配 置 


编写 文件 SystemConstjava， 功 能 是 


实现 系统 的 总 体 变量 配置 ， 这 些 变量 包括 服务 器 电话 、 控 制 方 


式 、 短 信服 务 、 城 市 名 称 、 更 新 频率 、 开 启 预案 、 服 务 器 地 址 和 端口 信息 等 。 文 件 SystemConstjava 


的 具体 实现 代码 如 下 所 示 。 
public class SystemConst { 


public static final String ОВ МАМЕ ="SmartHome Client.db"; 
public static final int DB_VERSION = 1; 


public static final String DB TABLE CONFIG = "system config"; 


public static final String KEY_ID="id"; 


public static final String KEY SERVER TEL = "server tel"; 

public static final String KEY CONTROL METHOD - "control method"; 
public static final String KEY CITY NAME = "city name"; 

public static final String KEY REFRESH SPEED = "refresh speed"; 
public static final String KEY WEATHER SERVICE = "weather service"; 
public static final String KEY LOCATION SERVICE - "location service"; 
public static final String KEY START TIME - "start time"; 

public static final String KEY SERVER IP 7 "server ip"; 

public static final String KEY SERVER COM = "server com"; 


} 
10.4.2 ”系统 总 体 配置 


编写 系统 设置 界面 的 布局 文件 system_setxml， 功 能 是 通过 文本 控件 、 文 本 框 控件 和 单 选 按钮 控件 
来 显示 当前 系统 的 设置 信息 。 文 件 system_set.xml 的 具体 实现 代码 如 下 所 示 。 


<AbsoluteLayout 
android:id="@+id/widgetO" 
android:layout_width="fill_parent" 
android:layout height-"fill parent" 


xmins:android="http://schemas.android.com/apk/res/android" 


> 


<EditText 
android:id="@+id/server_tel" 
android:layout_width="200px" 
android:layout_height="27dp" 
android:layout_x="111px" 
android:layout_y="9px" 
android:textSize="12sp" > 


</EditText> 

<TextView 
android:id="@+id/widget37" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
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android:text="8&#26381;8&#21 153;8&#22 120;8&#30005;&#35805;8#65306;" 
android:layout_x="6px" 
android:layout_y="21px" 

> 

</TextView> 

<TextView 
android:id="@+id/widget38" 
android:layout_width="wrap_content" 
android:layout height="wrap content" 
android:text="&#30005;&#22120;&#25511;&#21046;&#26041;&#24335;&#65306;" 
android:layout_x="5px" 
android:layout_y="73px" 

> 

</TextView> 

«RadioGroup 
android:id="@+id/radiogroup" 
android:layout_width="147px" 
android:layout_height="14px" 
android:orientation="horizontal" 
android:layout_x="115px" 
android:layout_y="64px" 

> 

</RadioGroup> 

<TextView 
android:id="@+id/location_text" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="8&#25552;&#20379;8&#23450;8#20301 ;&#30701;&#20449;&#26381;&#21153;&#65306;" 
android:layout x-"4px" 
android:layout_y="133px" 

> 

</TextView> 

<TextView 
android:id="@+id/city_text" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="8&#22478;&#24066;8&#21 51 7;8&#31216;8&#65288;8#25340;&#38899;&#65289 ;&#65306;" 
android:layout_x="4px" 
android:layout_y="182px" 

> 

</TextView> 


<EditText 
android:id="@+id/edit_city" 
android:layout_width="147dp" 
android:layout_height="30dp" 
android:layout_x="140dp" 
android:layout_y="171px" 
android:text="Beijing" 
android:textSize="12sp" > 
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</EditText> 

<TextView 
android:id="@+id/widget46" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="&#26356;&#26032;&#39057;&#29575;&#65306;" 
android:layout_x="6px" 
android:layout_y="226px" 

> 

</TextView> 

<TextView 
android:id="@+id/widget49" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="8#24320;8#21 551 ;&#22825;&#27 668; 8&#39044;&#26696 ;8#25552;&#3 1034 ;8#65306;" 
android:layout_x="6px" 
android:layout_y="265px" 

> 

</TextView> 

<TextView 
android:id="@+id/widget52" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="&#39044;&#26696 ;8#24320;8#2 1551 ;&#26 102; &#21051 ;&#65306;" 
android:layout_x="6px" 
android:layout_y="307px" 

> 

</TextView> 

<TextView 
android:id="@+id/widget56" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="Server_IP:" 
android:layout x-"6px" 
android:layout_y="346px" 

> 

</TextView> 


<TextView 
android:id="@+id/widget48" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_x="78dp" 
android:layout_y="153dp" 
android:text=" 秒 /次 " /> 


<EditText 
android:id="@+id/frequence" 
android:layout_width="139px" 
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android:layout_height="28dp" 
android:layout_x="118dp" 
android:layout_y="148dp" 
android:ems="10" 
android:text="60" 
android:textSize="12sp" /> 


<Button 
android:id="@+id/apply" 
android:layout_width="122dp" 
android:layout_height="wrap_content" 
android:layout_x="11dp" 
android:layout_y="340dp" 
android:text=" 应 用 系统 设置 " 
android:textStyle="bold" /> 


<TextView 
android:id="@+id/widget58" 
android:layout_width="wrap_content" 
android:layout height="wrap content" 
android:layout_x="153dp" 
android:layout y="231dp" 
android:text=" 0: "/> 


<EditText 
android:id="@+id/edit_ip" 
android:layout_width="83dp" 
android:layout_height="29dp" 
android:layout_x="70dp" 
android:layout_y="228dp" 
android:ems="10" 
android:text="127.0.0.1" 
android:textSize="12sp" /> 


<RadioButton 
android:id="@+id/radiobutton_blue" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_x="119dp" 
android:layout_y="40dp" 
android:text=" 蓝 牙 " /> 


<RadioButton 
android:id="@+id/radiobutton sms" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:layout_x="210dp" 
android:layout_y="40dp" 
android:checked="true" 
android:text=" 短 信 " /> 
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<CheckBox 
android:id="@+id/checkbox01" 
android:layout_width="82dp" 
android:layout height-"28dp" 
android:layout_x="130dp" 
android:layout y-"86dp" 
android:checked-"true" 
android:text-"ze" /> 


«EditText 
android:id="@+id/edit_com" 
android:layout_width="94dp" 
android:layout_height="30dp" 
android:layout_x="196dp" 
android:layout_y="232dp" 
android:ems="10" 
android:text="5432" 
android:textSize="12sp" /> 


<CheckBox 
android:id="@+id/checkbox_plan" 
android:layout width-"wrap content" 
android:layout_height="30dp" 
android:layout_x="118dp" 
android:layout_y="170dp" 
android:text=" 是 " /> 


<EditText 
android:id="@+id/planstart_time" 
android:layout_width="84dp" 
android:layout_height="34dp" 
android:layout_x="109dp" 
android:layout_y="196dp" 
android:ems="10" 
android:text="09:00" 
android:textSize="12sp" /> 


<Button 
android:id="@+id/reset" 
android:layout_width="124dp" 
android:layout height-"wrap content" 
android:layout_x="148dp" 
android:layout_y="340dp" 
android:text=" 取 消 系统 设置 " 
android:textStyle="bold" /> 


</AbsoluteLayout> 
编写 SystemSetjava 文件 , 功能 是 获取 设置 界面 文本 框 中 的 值 和 单 选 按 钮 的 值 , 并 将 这 些 值 保存 在 
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系统 数据 库 中 以 实现 系统 设置 功能 。 文 件 SystemSetjava 的 具体 实现 代码 如 下 所 示 。 
public class SystemSet extends Activity{ 


private EditText serverTel; 

private EditText serverlp; 

private EditText serverCom; 

private RadioButton smsMethodView; 
private RadioButton blue ToothMethodView; 
private EditText cityNameView; 

private EditText refreshSpeedView; 
private CheckBox weatherServiceView; 
private CheckBox locationServiceView; 
private EditText startTimeView; 

private Button applyBtn; 

private Button resetBtn; 

public static DBAdapter dbAdapter; 


public void onCreate(Bundle savedlnstanceState) ( 
super.onCreate(savedinstanceState); 
setContentView(R.layout.system_set); 


serverTel = (EditText)findViewByld(R.id.server_tel); 

serverlp = (EditText)findViewByld(R.id.edit_ip); 

serverCom = (EditText)findViewByld(R.id.edit_com); 
smsMethodView=(RadioButton)findViewByld(R.id.radiobutton_sms); 
blueToothMethodView=(RadioButton)findViewByld(R.id.radiobutton_blue); 
cityNameView=(EditText)findViewByld(R.id.edit_city); 
refreshSpeedView=(EditText)findViewByld(R.id.frequence); 
weatherServiceView=(CheckBox)findViewByld(R.id.checkbox_plan); 
locationService View=(CheckBox)find ViewByld(R.id.checkbox01); 
startTimeView=(EditText)findViewByld(R.id.planstart_time); 
applyBtn =(Button)findViewByld(R.id.apply); 

resetBtn = (Button)findViewByld(R.id.reset); 


dbAdapter = new DBAdapter(this); 
dbAdapter.open(); 
dbAdapter.LoadConfig(); 


applyBtn.setOnClickListener(new View.OnClickListener(){ 
public void onClick(View v) { 
SetNewData(); 
UpdateUi(); 
} 
}); 


resetBtn.setOnClickListener(new View.OnClickListener(){ 
public void onClick(View vX 
dbAdapter.LoadConfig(); 
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UpdateUi(); 
} 
W 


UpdateUi(); 
} 


private void SetNewData(){ 

Config.ServerTel = serverTel.getText().toString(); 

if(smsMethodView.isChecked()==true) 
Config.ControlMethod = "sms"; 

else { 
Config.ControlMethod = "bluetooth"; 

} 

if (blueToothMethodView.isChecked()==true) 
Config.ControlMethod = "bluetooth"; 

else { 
Config.ControlMethod = "sms"; 

) 

Config.CityName = cityNameView.getText().toString(); 

Config.RefreshSpeed = refreshSpeedView.getText().toString(); 


if (weatherServiceView.isChecked() == true) 
Config. WeatherService = "true"; 
else ( 
Config. WeatherService = "false"; 
) 
if (locationServiceView.isChecked()==true) 
Config.LocationService = "true"; 
else { 
Config.LocationService = "false"; 
} 
Config.StartTime = startTimeView.getText().toString(); 
Config.ServerlP = serverlp.getText().toString(); 
Config.ServerCom = serverCom.getText().toString(); 


dbAdapter.SaveConfig(); 
} 


private void UpdateUi()( 
serverTel.setText(Config.ServerTel); 


if(Config.ControlMethod.equals("sms")--true)( 
IlsmsMethodView.setChecked(false); 
//blueToothMethodView.setChecked(true); 

} 

locationServiceView.setChecked(Config.LocationService.equals("true")?true:false); 

cityNameView.setText(Config.CityName); 

refreshSpeedView.setText(Config.RefreshSpeed); 

weatherServiceView.setChecked(Config. WeatherService.equals("true")?true:false); 
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startTimeView.setText(Config.StartTime); 
serverlp.setText(Config.ServerlP); 
serverCom.setText(Config.ServerCom); 


) 
10.4.3 ”构建 数据 库 


本 系统 中 的 设置 信息 是 被 保存 在 SQLite 数据 库 中 的 ， 本 实例 通过 文件 DBOpenHelperjava 来 构建 
数据 库 的 参数 值 ， 具 体 实现 代码 如 下 所 示 。 
public class DBOpenHelper extends SQLiteOpenHelper{ 


public DBOpenHelper(Context context,String name, 
CursorFactory factory,int version ( 
super(context,name,factory,version); 


} 

IBN “RARE” RAH 

private static final String DB_CREATE_CONFIG = "create table " 
+ SystemConst.DB_TABLE CONFIG + " (" + SystemConst.KEY ID 
+" integer primary key autoincrement, " + SystemConst.KEY_SERVER_TEL 
+ " text not null, " + SystemConst.KEY_CONTROL_METHOD + " text, " 
+ SystemConst.KEY CITY NAME +" text, " + SystemConst.KEY REFRESH SPEED +" text," 
+ SystemConst.KEY_WEATHER_SERVICE + "text, "+ SystemConstKEY LOCATION SERVICE + "text," 
+ SystemConst.KEY_START_TIME + " text, "+ SystemConst.KEY_SERVER_IP +" text, "+SystemConst. 

KEY SERVER COM" text);"; 
MBN “RIAR” ж 
private final String DB CREATE RESERVEPLAN = "create table Reserve Plan ( id integer primary key 
autoincrement," 

+ "weather varchar(100), temperature varchar(100)," 
+ "solution varchar(300));"; 

@Override 

public void onCreate(SQLiteDatabase _ db) { 
II TODO Auto-generated method stub 
// 创 建 “ 系 统 设置 ”和 “天 和 气 预案 ” 表 
_db.execSQL(DB_CREATE_CONFIG); 
_db.execSQL(DB_ CREATE RESERVEPLAN); 
// 系 统 设置 默认 数据 加 载 
Config.LoadDefaultConfig(); 
/系统 设置 默认 数据 插入 数据 库 表 中 
ContentValues newValues = new ContentValues(); 
newValues.put(SystemConst.KEY_SERVER_TEL, Config.ServerTel); 
newValues.put(SystemConst.KEY_CONTROL_METHOD, Config.ControlMethod); 
newValues.put(SystemConst.KEY_CITY_NAME,Config.CityName); 
newValues.put(SystemConst.KEY REFRESH SPEED, Config.RefreshSpeed); 
newValues.put(SystemConst.KEY WEATHER SERVICE, Config. WeatherService); 
newValues.put(SystemConst.KEY LOCATION SERVICE, Config.LocationService); 
newValues.put(SystemConst.KXEY START TIME, Config.StartTime); 
newValues.put(SystemConst.KEY SERVER IP, Config.ServerlP); 
newValues.put(SystemConst.KEY SERVER COM, Config.ServerCom); 
. db.insert(DB CREATE CONFIG, null, newValues); 
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} 


@Override 
public void onUpgrade(SQLiteDatabase db, int oldVersion, int. newVersion) { 
11 TODO Auto-generated method stub 
_db.execSQL("DROP TABLE IF EXISTS"+SystemConst.DB_TABLE_CONFIG); 
_db.execSQL("DROP TABLE IF EXISTS Reserve_Plan"); 
onCreate(_db); 
} 


} 
编写 DBAdapterjava 文件 ， 功 能 是 根据 用 户 的 设置 信息 构建 或 更 新 数据 库 数据 ， 具 体 实现 代码 如 
下 所 示 。 
public class DBAdapter { 
private SQLiteDatabase db; 
private final Context context; 
private DBOpenHelper dbOpenHelper; 


public DBAdapter (Context _context){ 
context = context; 


} 


public void open()throws SQLiteException{ 
dbOpenHelper = new DBOpenHelper(context,SystemConst.DB_NAME,null,SystemConst.DB_VERSION); 
try( 
db = dbOpenHelper.getWritableDatabase(); 
)catch(SQLiteException ex)( 
db = dbOpenHelper.getReadableDatabase(); 
) 
) 


// 从 数据 库 查找 系统 设置 表 ， 加 载 数据 到 系统 常量 
public void LoadConfig(){ 
Cursor result = db.query(SystemConst.DB_TABLE_CONFIG, new String[ ] { SystemConst.KEY_ID, 
SystemConst.KEY_SERVER_TEL, SystemConst.KEY_CONTROL_METHOD, 
SystemConst.KEY_CITY_NAME, SystemConst.KEY_REFRESH_SPEED, 
SystemConst.KEY_WEATHER_SERVICE, SystemConst.KEY_LOCATION_SERVICE, 
SystemConst.KEY_START_TIME,SystemConst.KEY_SERVER_IP,SystemConst.KEY_SERVER_COM}, 
SystemConst.KEY ID + "=1", null, null, null, null); 
if (result.getCount() == 0 || !result.moveToFirst()){ 
return; 
} 
Config.ServerTel = result.getString(result.getColumnIndex(SystemConst.KEY SERVER TEL)); 
Config.ControlMethod = result.getString(result.getColumnIndex(SystemConst.KEY CONTROL - 
METHOD); 
Config.CityName = result.getString(result.getColumnIndex(SystemConst.KEY CITY NAME)); 
Config.RefreshSpeed =  result.getString(result.getColumnIndex(SystemConst.KEY REFRESH - 
SPEED); 
Config. WeatherService = result.getString(result.getColumnIndex(SystemConst.KEY WEATHER - 
SERVICE); 
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Config.LocationService = result.getString(result.getColumnindex(SystemConst.KEY _ 
LOCATION SERVICE)); 

Config.StartTime = result.getString(result.getColumnIndex(SystemConst.KEY START TIME)); 

Config.ServerlP -result.getString(result.getColumnIndex(SystemConst.KEY SERVER IP)); 

Config.ServerCom -result.getString(result.getColumnIndex(SystemConst.KEY SERVER СОМ)); 

Toast.makeText(context, "系统 设置 读 取 成 功 ", Toast.LENGTH_SHORT).show(); 


} 


public void SaveConfig(){ 
ContentValues updateValues = new ContentValues(); 
updateValues.put(SystemConst.KEY_CITY_NAME, Config.CityName); 
updateValues.put(SystemConst.KEY_CONTROL_METHOD, Config.ControlMethod); 
updateValues.put(SystemConst.KEY_LOCATION_SERVICE, Config.LocationService); 
updateValues.put(SystemConst.KEY_REFRESH_SPEED, Config.RefreshSpeed); 
updateValues.put(SystemConst.KEY SERVER COM, Config.ServerCom); 
updateValues.put(SystemConst.KEY SERVER ІР, Config.ServerlP); 
updateValues.put(SystemConst.KEY SERVER TEL, Config.ServerTel); 
updateValues.put(SystemConst.KEY START TIME, Config.StartTime); 
updateValues.put(SystemConst.KEY WEATHER SERVICE, Config. WeatherService); 
db.update(SystemConst.DB TABLE CONFIG, updateValues, 

SystemConst.KEY_ID+"=1", null); 

Toast.makeText(context, "系统 设置 保存 成 功 " Toast.LENGTH. SHORT ).show(); 


} 


public void close(){ 
if (db!=null){ 
db.close(); 
db = null; 


10.5 电器 控制 模块 


Ши 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 10 章 \ 电 器 控制 模块 .avi 

在 系统 主 界面 中 触摸 按 下 “电器 控制 ”图 标 后 会 来 到 如 图 10-3 所 示 的 界面 。 

由 此 可 见 ， 通 过 电器 控制 模块 可 以 控制 家 居 的 温度 、 电 灯 和 电扇 。 在 本 节 
的 内 容 中 ， 将 详细 讲解 本 章 电器 控制 模块 的 具体 实现 流程 。 


10.5.1 电器 控制 主 弄 面 


编写 布局 文件 devicecontrol.xml 实现 电器 控制 模块 的 主 界面 ， 在 主 界面 中 通过 ListView 控件 默认 
加 载 显示 温度 、 电 灯 和 电扇 3 个 列表 选项 。 文 件 devicecontrol.xml 的 具体 实现 代码 如 下 所 示 。 


<LinearLayout 
xmins:android="http://schemas.android.com/apk/res/android" 


图 10-3 电器 控制 界面 
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android:layout_width="fill_parent" 
android:layout height-"fill parent"> 
«ListView 
android:id-"(Q*id/ListViewO 1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
></ListView> 


</LinearLayout> 
编写 文件 DeviceControl.java 来 监听 用 户 触 摸 选 择 列表 的 选项 ， 根 据 用 户 选择 的 选项 来 到 指定 的 界 
面 。 文 件 DeviceControljava 的 具体 实现 代码 如 下 所 示 。 
public class DeviceControl extends Activity { 
public int n; 
public void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.devicecontrol); 


Jt Button buttonSearch = (Button )findViewByld(R.id.SearchState); 
Button buttonUpdate = (Button)findViewByld(R.id.UpdateState); 
Button buttonBack = (Button )findViewByld(R.id.back); 


final TextView textView = (TextView)findViewByld(R.id.StateOutput); 
n=(int)Math.random()*2; 


buttonSearch.setOnClickListener(new View.OnClickListener() { 
public void onClick(View view) { 


if (n==1) 
{ 
textView.setText(" 灯 是 亮 着 的 "); 
} 
if (n==0) 
{ 
textView.setText(" 灯 是 关 着 的 "); 


} 
» 


buttonUpdate.setOnClickListener(new View.OnClickListener() { 
public void onClick(View view) { 


if (n==1) 
{ 

n=0; 
} 
if (n==0) 
{ 

n=1; 
} 
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} 
p; 
buttonBack.setOnClickListener(new View.OnClickListener() ( 
public void onClick(View view) ( 
finish(); 
) 
pr 
ListView listView=(ListView) findViewByld(R.id.ListView01); 
List<String>list=new ArrayList<String>(); 
listadd ("im"); 
lis.add(" B XT"); 
list.add ("#353"); 
ArrayAdapter<String> adapter=new ArrayAdapter«String? (this,android.R.layout.simple list item 1,list); 


listView.setAdapter(adapter); 
listView.setOnltemClickListener(new listener()); 


) 
class listener implements OnltemClickListener{ 


@Override 
public void onltemClick(AdapterView<?> arg0, View arg], int arg2, 
long arg3) { 
II TODO Auto-generated method stub 
Intent intent; 
switch(arg2){ 
case 0: 
intent= new Intent (DeviceControl.this, Temperature.class); 
startActivity(intent); 
break; 
case 1: 
intent = new Intent(DeviceControl.this,Lights.class); 
startActivity (intent); 
break; 


} 
10.5.2 imi?) m 


当 在 电器 控制 主 界面 列表 中 选择 “温度 ”选项 后 会 来 到 温度 控制 界面 ， 此 界面 的 布局 文件 是 
temperature xml， 具体 实现 代码 如 下 所 示 。 

<AbsoluteLayout 

android:id="@+id/widget0" 

android:layout_width="fill_parent" 
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android:layout height-"fill parent" 
xmins:android="http://schemas.android.com/apk/res/android" 
> 

<LinearLayout 
android:id="@+id/widget36" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:orientation="vertical" 
android:layout_x="5px" 
android:layout_y="3px" 

2 

</LinearLayout> 

<Button 

android:id="@+id/search" 
android:layout_width="95px" 
android:layout_height="wrap_content" 
android:text="&#28201;&#24230;8&#26597 ;8#35810;" 
android:layout_x="11px" 
android:layout_y="378px" 

> 

</Button> 

<Button 

android:id="@+id/update" 
android:layout_width="102px" 
android:layout_height="44px" 
android:text="&#2 1047;&#26032;" 
android:layout_x="113px" 
android:layout_y="378px" 

> 

</Button> 

<Button 

android:id="@+id/back" 
android:layout_width="99px" 
android:layout_height="45px" 
android:text="8&#36820;8&#22238;" 
android:layout_x="221px" 
android:layout_y="378px" 

> 

</Button> 

<TextView 
android:id="@+id/outcome" 
android:layout_width="183px" 
android:layout_height="44px" 
android:text="" 
android:layout_x="67px" 
android:layout_y="160px" 

> 

</TextView> 

</AbsoluteLayout> 
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编写 Temperaturejava 文件 ， 功 能 是 监听 hE 击 按钮 在 界面 中 显示 当前 温度 ， 具 体 实现 代码 如 
下 所 示 。 
public class Temperature extends Activity { 
public void onCreate(Bundle savedlnstanceState) ( 
super.onCreate(savedinstanceState); 
setContentView(R.layout.temperature); 


Button buttonSearch = (Button)findViewByld(R.id.search); 
Button buttonUpdate = (Button)findViewByld(R.id.update); 
Button buttonBack = (Button)findViewByld(R.id.back); 


final TextView textView = (TextView)findViewByld(R.id.outcome); 


buttonSearch.setOnClickListener(new View.OnClickListener() { 
public void onClick(View view) { 
double n=Math.random()*100; 
textView.setText((int)n* "REC E"); 
) 
» 


buttonUpdate.setOnClickListener(new View.OnClickListener() ( 
public void onClick(View view) { 
double n=Math.random()*100; 
textView.setText((int)n* "REC E"); 
} 
» 
buttonBack.setOnClickListener(new View.OnClickListener() { 
public void onClick(View view) { 
finish(); 
) 
» 
) 
温度 控制 界面 的 执行 效果 如 图 10-4 所 示 。 
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图 10-4 温度 控制 界面 的 执行 效果 


10.5.3 ”电灯 控制 界面 


当 在 电器 控制 主 界面 列表 中 选择 “电灯 ”选项 后 会 来 到 电灯 控制 界面 ， 此 界面 的 布局 文件 是 
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lightxml， 功 能 是 在 屏幕 上 方 显示 不 同房 间 的 电灯 控制 按钮 ， 在 下 方 显示 操作 按钮 。 文 件 lightxml 的 
具体 实现 代码 如 下 所 示 。 
<AbsoluteLayout 
android:id="@+id/widgetO" 
android:layout_width="fill_ parent" 
android:layout height-"fill parent" 
xmins:android="http://schemas.android.com/apk/res/android" 
> 
<TextView 
android:id="@+id/keting_text" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="8&#23458;&#2 1381 ;&#28783;" 
android:layout_x="5px" 
android:layout_y="5px" 
> 
</TextView> 
<TextView 
android:id="@+id/zhuwo_text" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:text="8#20027;8&#21351 ;&#28783;" 
android:layout_x="5px" 
android:layout_y="76px" 
> 
</TextView> 
<RadioGroup 
android:id="@+id/radiogroup2" 
android:layout_width="165px" 
android:layout_height="42px" 
android:orientation="horizontal" 
android:gravity="center" 
android:layout_x="10px" 
android:layout_y="112px" 
> 
<RadioButton 
android:id="@+id/radiobutton2_on" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:text="&#24320;" 
android:textStyle="bold" 
> 


</RadioButton> 

<RadioButton 
android:id="@+id/radiobutton2_ off" 
android:layout_width="wrap_content" 


android:layout height-"wrap content" 
android:text="&#20851;" 
android:textStyle="bold" 
android:checked="true" 
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> 

</RadioButton> 

</RadioGroup> 

<RadioGroup 
android:id="@+id/radiogroup1" 
android:layout_width="163px" 
android:layout_height="44px" 
android:orientation="horizontal" 
android:gravity="center" 
android:layout_x="10px" 
android:layout_y="33px" 

> 

<RadioButton 
android:id="@+id/radiobutton1_on" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="8&#24320;" 
android:textStyle="bold" 
android:layout gravity-"center vertical" 
> 

</RadioButton> 

<RadioButton 
android:id-"(Q)*id/radiobutton1 off" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="8&#20851;" 
android:textStyle="bold" 
android:checked="true" 
android:layout gravity-"center vertical" 
> 

</RadioButton> 

</RadioGroup> 

<Button 

android:id="@+id/getstatus" 
android:layout_width="70px" 
android:layout height-"wrap content" 
android:padding="5px" 
android:text="8&#337 1 9;&#21462;8&#29366;8#24577;" 
android:textStyle="bold" 
android:layout_x="5px" 
android:layout_y="300px" 

> 

</Button> 

<Button 

android:id="@+id/refresh" 
android:layout_width="70px" 
android:layout height-"wrap content" 
android:text="&#2 1 047;&#26032;8#26174;8#31034;" 
android:textStyle="bold" 
android:layout_x="78px" 
android:layout_y="300px" 
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> 

</Button> 

<Button 

android:id="@+id/reset* 
android:layout_width="70px" 
android:layout_height="wrap_content" 
android:text-" 84537 325;8&#26032;8#35774;8#23450;" 
android:textStyle="bold" 
android:layout_x="150px" 
android:layout_y="300px" 

> 

</Button> 

<Button 

android:id="@+id/back" 
android:layout_width="70px" 
android:layout_height="wrap_content" 
android:text="8#36820;8#22238;" 
android:textStyle="bold" 
android:layout_x="220px" 
android:layout_y="300px" 

> 

</Button> 

</AbsoluteLayout> 


编写 文件 Lights.java 获取 用 户 对 不 同房 间 电灯 的 控制 按钮 值 ， 并 监听 用 户 触摸 单 击 操作 按钮 值 ， 
通过 这 两 个 值 实现 对 家 居 电 灯 的 控制 管理 功能 。 文 件 Lights java 的 具体 实现 代码 如 下 所 示 。 
public class Lights extends Activity implements OnClickListener{ 


private static RadioButton radioButton01; 
private static RadioButton radioButton02; 
@Override 
public void onClick(View argO) { 
II TODO Auto-generated method stub 
switch(arg0.getld()) { 
case R.id.back: 
finish(); 
Intent intent = new Intent(Lights.this, DeviceControl.class ); 
startActivity(intent); 


break; 
case R.id.reset: 


SendSMS("13889609674" newStatus()); 
Toast.makeText(this,newStatus(), Toast.LENGTH LONG).show(); 


break; 
} 
} 
private String newStatus(){ 
StringBuilder ns = new StringBuilder(); 
ns.append("10*keting*"); 
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if(radioButton01.isChecked()) 
ns.append("1"); 
if(radioButton02.isChecked()) 
ns.append("0"); 
return ns.toString(); 


} 
private void SendSMS(String telnumer,String content){ 
Intent intent = new Intent( 
“android.provider.Telephony.SMS_ SEND"); 
SmsManager smsManager = SmsManager.getDefault(); 
PendingIntent трі = PendingIntent.getBroadcast( 
this,0,intent,PendingIntent.FLAG_ONE_SHOT); 
smsManager.sendTextMessage(telnumer, null, 
content,mpi,null); 


} 
@Override 
protected void onCreate(Bundle savedinstanceState) { 
II TODO Auto-generated method stub 
super.onCreate(savedinstanceState); 
setContentView(R.layout. light); 
Button backButton=(Button)findViewByld(R.id.back); 
Button refreshButton-(Button find ViewByld(R.id.refresh); 
Button getButton=(Button )findViewByld(R.id.getstatus); 
Button setButton=(Button)findViewByld(R.id.reset); 
radioButton01=(RadioButton)findViewByld(R.id.radiobutton1_on); 
radioButton02=(RadioButton)findViewByld(R.id.radiobutton1_ off); 
backButton.setOnClickListener(this); 
refreshButton.setOnClickListener(this); 
getButton.setOnClickListener(this); 
setButton.setOnClickListener(this); 
} 
} 
电灯 控制 界面 的 执行 效果 如 图 10-5 所 示 。 
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图 10-5 电灯 控制 界面 的 执行 效果 
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10.6 ”预案 管理 模块 


GH 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 10 章 \ 预 案 管理 模块 .avi 

为 了 方便 系统 管理 ， 在 本 智能 家 居 系 统 中 预先 设置 了 预案 管理 模块 。 通 过 预案 管理 模块 ， 可 以 快 
速 地 对 天 气 情况 、 历 史 数据 和 系统 设置 信息 进行 浏览 并 管理 。 在 本 节 的 内 容 中 ， 将 详细 讲解 本 系统 预 
案 管理 模块 的 具体 实现 流程 。 


10.6.1 天 气 情况 


编写 lx_weather.xml 文件 在 屏幕 中 构建 一 个 天 气 预 报 界 面 ， 通 过 传感器 获取 当前 的 温度 、 湿 度 和 4 
天 的 天 气 情况 。lx_weather.xml 文件 的 具体 实现 代码 如 下 所 示 。 
«LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="fill_parent" 
android:layout height-"fill parent" 
> 
<TextView android:id="@+id/tab_weather_current_condition" 
android:layout_width="fill_ parent" 
android:layout height-"wrap content" 
android:text="Temperature:60, Humidity:64%"> 
</TextView> 
<TextView android:id="@+id/tab_weather_current_wind" 
android:layout_width="fill_ parent" 
android:layout_height="wrap_content" 
android:text="Wind:N at 2 mph, 2009-09-20 12:21:00 +0000"> 
</TextView> 


«ImageView android:id="@+id/tab_weather_current_image" 
android:src="@drawable/sunny" 
android:layout gravity-"center vertical|center horizontal" 
android:layout marginBottom-"8dip" android:layout marginTop-"15dip" 


android:layout height-"100dip" android:layout_width="100dip"/> 


«TextView android:id-"(g)*id/tab weather current city" 
android:layout_width="fill_ parent" 
android:layout height-"wrap content" 
android:text="New York, NY" 
android:gravity-"center vertical|center horizontal"» 
</TextView> 


<LinearLayout android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation="horizontal" android:layout_marginTop="20dip"> 
<LinearLayout android:orientation="vertical" 
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android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:layout_weight="1"> 
<TextView android:id="@t+id/tab_weather_d1_date" 
android:layout_width="fill_ parent" 
android:layout_height="wrap_content" 
android:text="Mon" 
android:gravity="center_horizontal"> 
</TextView> 
«ImageView android:id="@+id/tab_weather_d1_image" 
android:layout marginTop-"3dip" 
android:layout marginBottom-"3dip" 
android:src="@drawable/sunny" 


android:layout gravity-"center vertical|center horizontal" 
android:layout_height="40dip" 
android:layout_width="40dip"/> 
<TextView android:id="@tid/tab weather d1 temperature" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text="15/29" 
android:gravity="center_horizontal"> 
</TextView> 
</LinearLayout> 
<LinearLayout android:orientation="vertical" 
android:layout width-"fill parent" 
android:layout_height="fill_ parent" 
android:layout_weight="1"> 
<TextView android:id="@+id/tab weather 42 date" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Tue" 
android:gravity="center_horizontal"> 
</TextView> 
<ImageView android:id="@+id/tab_ weather 42 image" 
android:layout marginTop-"3dip" 
android:layout marginBottom-"3dip" 
android:src="@drawable/sunny" 


android:layout_gravity="center_vertical|center_horizontal" 
android:layout_height="40dip" 
android:layout_width="40dip"/> 
<TextView android:id="@tid/tab_weather_d2_temperature" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text="15/29" 
android:gravity="center_horizontal"> 
</TextView> 
</LinearLayout> 
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<LinearLayout android:orientation="vertical" 
android:layout_width="fill_ parent" 
android:layout_height="fill_ parent" 
android:layout_weight="1"> 
<TextView android:id="@+id/tab weather d3 date" 
android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
android:text="Wed" 
android:gravity="center_horizontal"> 
</TextView> 
«ImageView android:id="@+id/tab_ weather d3 image" 
android:layout marginTop-"3dip" 
android:layout marginBottom-"3dip" 
android:src="@drawable/sunny" 


android:layout_gravity="center_vertical|center_horizontal" 
android:layout_height="40dip" 
android:layout_width="40dip"/> 
<TextView android:id-"(Q*id/tab weather d3 temperature" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text="15/29" 
android:gravity="center_horizontal"> 
</TextView> 
</LinearLayout> 
<LinearLayout android:orientation="vertical" 
android:layout width-"fill parent" 
android:layout heightz"fill parent" 
android:layout_weight="1"> 
<TextView android:id="@+id/tab_weather_d4_date" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Thu" 
android:gravity="center_horizontal"> 
</TextView> 
<ImageView android:id="@+id/tab_weather_d4_image" 
android:layout_marginTop="3dip" 
android:layout_marginBottom="3dip" 
android:src="@drawable/sunny" 


android:layout_gravity="center_vertical|center_horizontal" 
android:layout_height="40dip" 
android:layout_width="40dip"/> 
<TextView android:id-"(g*id/tab weather d4 temperature" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-" 15/29" 
android:gravity="center_horizontal"> 
</TextView> 
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</LinearLayout> 
</LinearLayout> 
</LinearLayout> 
编写 文件 Lx_weatherjava 获取 指定 城市 的 天 气 信息 , 并 监听 用 户 触摸 是 否 按 下 设备 上 的 MENU 按 
键 。 文 件 Lx_weatherjava 的 具体 实现 代码 如 下 所 示 。 
public class Lx_weather extends Activity{ 
final static int MENU_START_SERVICE= Menu.FIRST ; 
final static int MENU STOP SERVICE = Menu.FIRST + 1; 
final static int MENU_REFRESH = Menu.FIRST + 2; 
final static int MENU QUIT = Menu.FIRST +3; 


private Ix DBAdapter dbAdapter ; 


@Override 
public void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlInstanceState); 
setContentView(R.layout.Ix weather); 


dbAdapter 7 new Ix DBAdapter(this); 
dbAdapter.open(); 
dbAdapter.LoadConfig(); 


@Override 
public boolean onCreateOptionsMenu(Menu menu) 


menu.add(0,MENU START. SERVICE,0," B zl Ri &"); 
menu.add(0MENU STOP SERVICE,1,"I 1E ARS"); 
menu.add(0,MENU REFRESH ,2," 刷 新 "); 
menu.add(0,MENU_QUIT,3," 退 出 "); 
return true; 

} 


@Override 
public boolean onOptionsltemSelected(Menultem item){ 
final Intent servicelntent = new Intent(this, Ix WeatherService.class); 
switch(item.getltemld())( 
case MENU REFRESH: 
RefreshWeatherData(); 
return true; 
case MENU START SERVICE: 
startService(servicelntent); 
return true; 
case MENU STOP SERVICE: 
stopService(servicelntent); 
return true; 
case MENU QUIT: 
finish(); 
break; 
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} 


} 


return false; 


private void RefreshWeatherData()( 


// 当 前 温度 


TextView currentCondition = (TextView)findViewByld(R.id.tab_ weather current condition); 
TextView currentWind = (TextView)findViewByld(R.id.tab weather current wind); 
ImageView currentImage = (ImageView)findViewByld(R.id.tab weather current image); 
TextView currentCity = (TextView)findViewByld(R.id.tab weather current city); 


String msgCondition = ""; 

msgCondition += "Temperature: "+ Іх Weather.current temp +", "; 
msgCondition += Ix Weather.current humidity ; 
currentCondition.setText(msgCondition); 


currentWind.setText(Ix Weather.current wind + ", " + Ix Weather.current date time); 
currentlmage.setimageBitmap(Ix Weather.current image); 
currentCity.setText(Ix Weather.city); 


/预报 : 第 1 天 
TextView forcastD1Date = (TextView)findViewByld(R.id.tab_weather_d1_date); 
ImageView forcastD1Image = (ImageView)findViewByld(R.id.tab_weather_d1_image); 
TextView forcastD1Temperature = (TextView)findViewByld(R.id.tab weather d1 temperature); 


forcastD1Date.setText(Ix_Weather.day[0].day_of week); 
forcastD1Image.setlmageBitmap(Ix_Weather.day[0].image); 


String msgD1Temperature = Ix Weather.day[0].high + "/" + Ix Weather.day[0].low; 
forcastD 1Temperature.setText(msgD 1Temperature); 


ІВ: 第 2 天 
TextView forcastD2Date = (TextView)findViewByld(R.id.tab_weather_d2_date); 
ImageView forcastD2Image = (ImageView)findViewByld(R.id.tab_weather_d2_image); 
TextView forcastD2Temperature = (TextView)findViewByld(R.id.tab weather d2 temperature); 


forcastD2Date.setText(Ix Weather.day[1].day of week); 
forcastD2Image.setimageBitmap(Ix_Weather.day[1].image); 


String msgD2Temperature = Ix Weather.day[1].high + "/" + Ix Weather.day[1].low; 
forcastD2Temperature.setText(msgD2Temperature); 


/预报 : 第 3 天 
TextView forcastD3Date = (TextView)findViewByld(R.id.tab_weather_d3_date); 
ImageView forcastD3lmage = (ImageView)findViewByld(R.id.tab weather d3 image); 
TextView forcastD3Temperature = (TextView)findViewByld(R.id.tab weather d3 temperature); 


forcastD3Date.setText(Ix Weather.day[2].day of week); 
forcastD3lmage.setlmageBitmap(Ix Weather.day[2].image); 
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String msgD3Temperature = lx_Weather.day[2].high + "/" + lx_Weather.day[2].low; 
forcastD3Temperature.setText(msgD3Temperature); 


/预报 : 第 4 天 
TextView forcastD4Date = (TextView)findViewByld(R.id.tab weather d4 date); 
ImageView forcastD4Image = (ImageView)findViewByld(R.id.tab weather d4 image); 
TextView forcastD4Temperature = (TextView)findViewByld(R.id.tab weather d4 temperature); 


forcastD4Date.setText(Ix Weather.day[3].day of week); 
forcastD4Image.setlmageBitmap(Ix Weather.day[3].image); 


String msgD4Temperature = Ix Weather.day[3].high + "/" + Ix Weather.day[3].low; 
forcastD4Temperature.setText(msgD4Temperature); 


} 
编写 文件 WeatherO1 java 在 屏幕 顶端 显示 “天 气 预报 “历史 数据 ”和 “系统 设置 ”3 个 选项 卡 ， 
具体 实现 代码 如 下 所 示 。 
public class Weather01 extends TabActivity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
//setContentView(R.layout.main); 


TabHost tabHost=getTabHost(); 
tabHost.addTab(tabHost.newTabSpec("TAB1").setIndicator("% & Fidi", getResources(). 
getDrawable(R.drawable.tab weather)).setContent(new Intent(this,Lx weather.class))); 
tabHost.addTab(tabHost.newTabSpec("TAB2").setlndicator(" J $3138" getResources(). 
getDrawable(R.drawable.tab history)).setContent(new Intent(this,Lx history.class))); 
tabHost.addTab(tabHost.newTabSpec("TAB3").setlndicator(" 9:19 ",getResources(). 
getDrawable(R.drawable.tab setup)).setContent(new Intent(this,Lx setup.class))); 


} 
} 
编写 文件 k_WeatherAdapterjava， 功 能 是 在 线 获取 当前 指定 城市 的 天 气 信息 ， 有 具体 实现 代码 如 下 
所 示 。 


public class Ix WeatherAdapter { 
public static void GetWeatherData() throws IOException, Throwable { 
String queryString = "http://www.google.com/ig/api?weather=" + Ix Config.CityName; 
URL aURL = new URL(queryString.replace(" ", "%20")); 
URLConnection conn = aURL.openConnection(); 
conn.connect(); 
InputStream is = conn.getInputStream(); 


XmlPullParserFactory factory = XmiPullParserFactory.newinstance(); 


factory.setNamespaceAware(true); 
XmlPullParser parser = factory.newPullParser(); 
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parser.setInput(is," UTF-8"); 


int dayCounter 7 0; 
while(parser.next()!= XmIPullParser.END_DOCUMENT){ 
String element = parser.getName(); 
if (element != null && element.equals("forecast_information")){ 
while(trueX{ 
int eventCode = parser.next(); 
element = parser.getName(); 
if (eventCode == XmlPullParser.START TAG)( 
if (element.equals('city")( 
Ix Weather.city = parser.getAttributeValue(0); 
Jelse if (element.equals("current date time"))( 
Ix Weather.current date time = parser.getAttributeValue(0); 
) 
) 


if (element.equals("forecast information") && 
eventCode == XmlPullParser.END TAG)( 
break; 


} 
} 


if (element != null && element.equals("current_conditions")){ 
while(true){ 
int eventCode = parser.next(); 
element = parser.getName(); 
if (eventCode == XmlPullParser.START TAG)( 
if (element.equals("condition")){ 
Ix Weather.current condition = parser.getAttributeValue(0); 
}else if (element.equals("temp f") 
Ix Weather.current temp = parser.getAttributeValue(0); 
else if (element.equals("humidity") ){ 
Ix Weather.current humidity = parser.getAttributeValue(0); 
}else if (element.equals("wind condition") 
Ix Weather.current wind = parser.getAttribute Value(0); 
Jelse if (element.equals("icon"))( 
Ix Weather.current image url 7 parser.getAttributeValue(0); 
Ix Weather.current image = GetURLBitmap(Ix Weather.current image url); 


) 


if (element.equals("current conditions") && 
eventCode == XmlPullParser.END TAG)( 
break; 


) 
H 


if (element != null && element.equals("forecast conditions"))( 
while(true( 
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int eventCode = parser.next(); 
element= parser.getName(); 
if (eventCode == XmiPullParser.START_TAG) 
if (element.equals("day of week") 
Ix Weather.day[dayCounter].day of week = parser.getAttributeValue(0); 
Jelse if (element.equals(“low")){ 
Ix Weather.day[dayCounter].low = parser.getAttributeValue(0); 
Jelse if (element.equals("high") 


Ix Weather.day[dayCounter].high = parser.getAttributeValue(0); 

Jelse if (element.equals("icon"))( 
Ix Weather.day[dayCounter].image url = parser.getAttributeValue(0); 
Ix Weather.day[dayCounter].image = GetURLBitmap(Ix Weather.day[dayCounter]. 

image url); 

Jelse if (element.equals("condition")){ 
Ix Weather.day[dayCounter].condition 7 parser.getAttributeValue(0); 

) 

) 


if (element.equals("forecast conditions") && 
eventCode == XmlPullParser.END TAG)( 
dayCounter++; 
break; 


} 
} 


is.close(); 


} 
private static Bitmap GetURLBitmap(String urlString)( 


URL url = null; 

Bitmap bitmap = null; 

try { 

url = new URL ("http://www.google.com" + urlString); 

} 

catch (MalformedURLException e)( 
e.printStackTrace(); 

} 

try{ 
HttpURLConnection conn = (HttpURLConnection) url.openConnection(); 
conn.connect(); 
InputStream is = conn.getinputStream(); 
bitmap = BitmapFactory.decodeStream(is); 
is.close(); 

} 

catch (IOException eX{ 
e.printStackTrace(); 

) 

return bitmap; 
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} 
} 
编写 文件 lx_WeatherService.java， 功 能 是 根据 用 户 选择 的 选项 来 启动 或 停止 当前 的 天 气 服 务 活动 ， 
具体 实现 代码 如 下 所 示 。 
public class Ix WeatherService extends Service{ 
private Ix DBAdapter dbAdapter ; 
private Thread workThread; 
private static ArrayList<Ix_SimpleSms> smsList = new ArrayList<Ix_SimpleSms>(); 
private static int timeCounter = 1; 


public static void RequerSMSService(Ix SimpleSms sms) 
if (Ix_Config.ProvideSmsService.equals("true")){ 
smsList.add(sms); 
} 
} 
private void SaveSmsData(Ix_SimpleSms sms) 
if (Ix Config.SaveSmslnfo.equals("true")( 
dbAdapter.SaveOneSms(sms); 


} 
} 
@Override 
public void onCreate() { 
super.onCreate(); 
dbAdapter = new Ix DBAdapter(this); 
dbAdapter.open(); 
Toast.makeText(this, "启动 天 气 服务 ", Toast.LENGTH LONG).show(); 
workThread = new Thread(null,backgroudWork,"WorkThread"); 
} 
@Override 


public void onStart(Intent intent, int startld) { 
super.onStart(intent, startld); 
if (IworkThread.isAlive()( 


workThread.start(); 
) 

} 

@Override 

public void onDestroy() ( 
super.onDestroy(); 
Toast.makeText(this, "天 气 服务 启动 停止 ", Toast.LENGTH_SHORT).show(); 
workThread.interrupt(); 

} 

@Override 

public IBinder onBind(Intent intent) { 
return null; 

} 


private Runnable backgroudWork = new Runnable(){ 
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@Override 
public void run() { 
try { 
while(!Thread.interrupted())( 
ProcessSmsList(); 
GetGoogleWeatherData(); 
Thread.sleep(1000); 
} 
} catch (InterruptedException e) { 
e.printStackTrace(); 
} 
} 
y 
private void ProcessSmsList()( 
if (smsList.size()==0){ 
retum; 
} 
SmsManager smsManager = SmsManager.getDefault(); 
PendingIntent mPi = PendingIntent.getBroadcast(this, 0, new Intent(), 0); 
while(smsList.size()>0){ 
Ix SimpleSms sms = smsList.get(0); 
smsList.remove(0); 
smsManager.sendTextMessage(sms.Sender, null, Ix Weather.GetSmsMsg(), mPi, null); 
sms.RetumResult = Ix Weather.GetSmsMsg(); 
SaveSmsData(sms); 
} 
} 


private void GetGoogleWeatherData(){ 
Log.i("TIMER",String.valueOf(timeCounter)); 
if (timeCounter-- < 0){ 
timeCounter = Integer.parselnt(Ix_Config.RefreshSpeed); 
Log.i("TIMER","NOW"); 


try f 
Ix WeatherAdapter.GetWeatherData(); 
} catch (IOException e) { 
11 TODO Auto-generated catch block 
e.printStackTrace(); 
} catch (Throwable e) { 
11 TODO Auto-generated catch block 
e.printStackTrace(); 
} 


} 
} 


天 气 情 况 模 块 执行 后 面 的 效果 如 图 10-6 所 示 。 
用 户 触摸 按 下 设备 MENU 按键 后 的 执行 效果 如 图 10-7 所 示 。 
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图 10-6 “天 气 情况 模块 的 执行 效果 
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图 10-8 历史 数据 界面 


编写 文件 lx_history.xml， 功 能 是 通过 ListView 控件 列表 显示 系统 内 的 历史 短信 


码 如 下 所 示 。 
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<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="fill_ parent" 
android:layout height-"fill parent" 
android:background="@drawable/black"> 


«TextView  android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"SQLite 数据 库 中 的 短信 服务 信息 : "> 

</TextView> 

<ListView android:id="@android:id/list" 

android:layout_width="fill_ parent" 

android:layout_height="wrap_content" 
android:layout_marginTop="2dip"> 
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图 10-7 4% F MENU 按键 后 的 执行 效果 


选择 “历史 数据 ”选项 后 会 来 到 系统 的 历史 数据 界面 ， 如 图 10-8 所 示 。 


具体 实现 代 


</ListView> 
</LinearLayout> 
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编写 文件 Lx_historyjava 获取 系统 数据 库 中 的 历史 信息 , 并 且 根据 监听 用 户 触摸 按 下 设备 的 MENU 
按键 值 来 进行 对 应 的 操作 。 文 件 Lx_historyjava 的 具体 实现 代码 如 下 所 示 。 


public class Lx_history extends ListActivity{ 


final static int MENU_REFRESH = Menu.FIRST; 
final static int MENU_DELETE = Menu.FIRST+1; 
final static int MENU QUIT = Menu.FIRST+2; 


private Ix DBAdapter dbAdapter ; 
private Ix SmsAdapter dataAdapter; 
@Override 
public void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.Ix history); 


dbAdapter = new Ix DBAdapter(this); 


dbAdapter.open(); 
dataAdapter = new Ix SmsAdapter(this); 
setListAdapter(dataAdapter); 

} 

@Override 


public boolean onCreateOptionsMenu(Menu menu) 
menu.add(0,MENU REFRESH ,0," 刷 新 "); 
menu.add(0,MENU_DELETE,1," 清 空 数据 "); 
menu.add(0,MENU_QUIT,1," 退 出 "); 
return true; 

} 


@Override 
public boolean onOptionsltemSelected(Menultem item){ 
switch(item.getltemld())( 
case MENU_REFRESH: 
Ix SmsAdapter.RefreshData(); 
setListAdapter(dataAdapter); 
return true; 
case MENU DELETE: 
dbAdapter.DeleteAllSms(); 
return true; 
case MENU QUIT: 
finish(); 
break; 
} 
return false; 


} 


} 


当 触 摸 选 择 某 一 条 历史 数据 时 会 调用 文件 k_SmsAdapterjava 显示 这 条 数据 的 详细 信息 , 具体 实现 


代码 如 下 所 示 。 


281 


Е: Android 外 设 开 发 实战 


public class Ix_SmsAdapter extends BaseAdapter{ 


private LayoutInflater minflater; 
private static Ix DBAdapter dbAdapter ; 
private static Ix SimpleSms[ ] smsList ; 


public Ix SmsAdapter(Context context) 
{ 


minflater = Layoutinflater.from(context); 
dbAdapter = new Ix DBAdapter(context); 
dbAdapter.open(); 
smsList = dbAdapter.GetAllSms(); 

} 


public static void RefreshData()( 
smsList = dbAdapter.GetAllSms(); 
} 


@Override 
public int getCount() { 
if (smsList == null) 


return 0; 
else 
return smsList.length; 
} 
@Override 


public Object getltem(int position) ( 
if (smsList == null) 
return 0; 
else 
return smsList[position]; 


} 


@Override 
public long getltemld(int position) { 
return position; 


} 


@Override 
public View getView(int position, View convertView, ViewGroup parent) { 
ViewHolder holder; 


if(convertView == null){ 
convertView = mlnflater.inflate(R.layout.Ix datarow, null); 
holder = new ViewHolder(); 
holder.textRow01 = (TextView) convertView.findViewByld(R.id.data row 01); 
holder.textRow02 = (TextView) convertView.find ViewByld(R.id.data row 02); 


convertView.setTag(holder); 
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else{ 
holder = (ViewHolder) convertView.getTag(); 


} 


if (smsList != null)( 


String row01Msg =" ("+position+") "+" 4i&#: "+ smsList[position] Sender*", "+smsList[position]. 


ReceiveTime; 
holder.textRow01.setText(row01Msg); 
holder.textRow02.setText(smsList[position].ReturnResult); 
} 
return convertView; 
} 
private class ViewHolder{ 
TextView textRow01; 
TextView textRow02; 
} 


} 
10.6.3 ”系统 设置 


当 在 屏幕 项 部 选择 “系统 设置 ”选项 后 会 来 到 系统 设置 界面 ， 如 图 10-9 所 示 。 


图 10-9 系统 设置 界面 的 执行 效果 


编写 文件 lx_setup.xml， 功 能 是 通过 文本 框 控件 和 复 选 框 显示 系统 设置 信息 ， 具 体 实 现代 码 如 下 所 示 。 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 

android:orientation-"vertical" 

android:layout width-"fill parent" 

android:layout height-"fill parent" 

> 

<LinearLayout android:orientation="horizontal" 

android:layout width-"fill parent" 

android:layout height-"wrap content"» 

«TextView  android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text=" 城 市 名 称 〈 拼 音 ) : "> 

</TextView> 

«EditText android:id="@+id/tab_setup_city_name" 
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android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
android:text="Haerbin" > 
</EditText> 
</LinearLayout> 


<LinearLayout android:orientation="horizontal" 
android:layout_width="fill_ parent" 
android:layout_height="wrap_content"> 
<TextView 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text=" 更 新 频率 : "> 
</TextView> 
<EditText android:id="@+id/tab_setup_refresh_speed" 
android:layout_width="120dip" 
android:layout_height="Wrap_content" 
android:numeric="integer" 
android:text="600" > 
</EditText> 
<TextView android:layout_width="wrap_content" 
android:layout height="wrap content" 
android:text=" 秒 /次 "> 
</TextView> 
</LinearLayout> 


<LinearLayout android:orientation="horizontal" 
android:layout_width="fill_ parent" 
android:layout_height="wrap_content"> 
<TextView android:layout_width="wrap_ content" 
android:layout_height="wrap_content" 
android:text=" 提 供 短信 服务 : "> 
</TextView> 


<CheckBox android:id="@+id/tab_setup_sms_service" 
android:text-" e" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:checked-"true"» 
</CheckBox> 
</LinearLayout> 


«LinearLayout android:orientation-"horizontal" 
android:layout width-"fill parent" 
android:layout height-"wrap content"» 

«TextView  android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text=" 记 录 短 信服 务 数据 信息 : "> 

</TextView> 


<CheckBox android:id="@+id/tab_setup_save_sms_info" 
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android:text="2" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:checked="true"> 
</CheckBox> 
</LinearLayout> 


<LinearLayout android:orientation-"horizontal" 
android:layout_width="fill_ parent" 
android:layout_height="wrap_content"> 
<TextView 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text=" 短 信服 务 关 键 字 : "> 
</TextView> 
«EditText android:id="@+id/tab setup key work" 
android:layout_width="120dip" 
android:layout_height="Wrap_content" 
android:text="WR" > 
</EditText> 
</LinearLayout> 


<LinearLayout android:orientation="horizontal" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:layout marginTop-"5dip"» 


«Button android:id-"(g)*id/tab setup apply" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text=" 应 用 系统 设置 
android:layout_weight="1" android:layout_gravity="bottom"> 

</Button> 

«Button android:id="@+id/tab_setup_cancel" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text=" 取 消 系统 设置 " 
android:layout_weight="1" android:layout_gravity="bottom"> 

</Button> 

</LinearLayout> 
</LinearLayout> 


编写 文件 lx_Config.java， 功 能 是 预先 设置 系统 设置 变量 的 初始 值 ， 具 体 实现 代码 如 下 所 示 。 


public class Ix Config { 
public static String CityName; 
public static String RefreshSpeed; 
public static String ProvideSmsService; 
public static String SaveSmslnfo; 
public static String KeyWord; 
public static void LoadDefaultConfig(){ 

CityName = "济南 "; 
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} 


} 


RefreshSpeed = "60"; 
ProvideSmsService = "true"; 
SaveSmsinfo = "true"; 
KeyWord = "无 敌 "; 


编写 文件 lx_DBAdapterjava， 功 能 是 根据 用 户 的 设置 值 对 数据 库 进行 更 新 ， 具 体 实现 代码 如 下 所 示 。 
public void SaveConfig(){ 


} 


ContentValues updateValues = new ContentValues(); 
updateValues.put(KEY CITY NAME, Ix Config.CityName); 
updateValues.put(KEY REFRESH SPEED, Ix Config.RefreshSpeed); 
updateValues.put(KEY SMS SERVICE, Ix Config.ProvideSmsService); 
updateValues.put(KEY SMS INFO, Ix Config.SaveSmsInfo); 
updateValues.put(KEY KEY WORD, Ix Config.KeyWord); 


db.update(DB TABLE CONFIG, updateValues, KEY ID + "=" + DB CONFIG ID, null); 


Toast.makeText(context, "系统 设置 保存 成 功 , Toast. LENGTH SHORT).show(); 


public void LoadConfig(){ 
Cursor result = db.query(DB TABLE CONFIG, new String[] ( KEY ID, KEY CITY NAME, KEY 
REFRESH SPEED, 


KEY. SMS. SERVICE, KEY. SMS. INFO, KEY. KEY WORD), 
KEY. ID + "=" + DB CONFIG ID, null, null, null, null); 


if (result.getCount() == 0 || !result.moveToFirst())( 


) 


retum; 


Ix Config.CityName = result.getString(result.getColumnIndex(KEY CITY NAME)); 

Ix Config.RefreshSpeed =  result.getString(result.getColumnIndex(KEY REFRESH SPEED)); 
Ix Config.ProvideSmsService = result.getString(result.getColumnIndex(KEY SMS SERVICE)); 
Ix Config.SaveSmslnfo =  result.getString(result.getColumnIndex(KEY SMS INFO)); 

Ix Config.KeyWord = result.getString(result.getColumnindex(KEY_ KEY WORD)); 


Toast.makeText(context, "系统 设置 读 取 成 功 ", Toast.LENGTH_SHORT).show(); 


/* 静态 Helper 类 ， 用 于 建立 、 更 新 和 打开 数据 库 */ 
private static class DBOpenHelper extends SQLiteOpenHelper { 


public DBOpenHelper(Context context, String name, CursorFactory factory, int version) { 
super(context, name, factory, version); 


} 


private static final String DB CREATE CONFIG = "create table " + 
DB_TABLE_CONFIG +" ("+ KEY ID + " integer primary key autoincrement, " + 
KEY_CITY_NAME+ " text not null, "+ KEY_REFRESH_SPEED+ " text," + 
KEY SMS SERVICE +" text, "+ KEY SMS INFO + "text, " + 
KEY KEY WORD + " text);"; 
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private static final String DB CREATE SMS = "create table "+ 
DB TABLE SMS +" (" + КЕҮ 10 + " integer primary key autoincrement, " + 
KEY SENDER*t " text not null, "+ KEY_BODY+ "text, " + 
KEY RECEIVE TIME +" іехі, "+ KEY_RETURN_RESULT + " text);"; 


@Override 

public void onCreate(SQLiteDatabase _ db) { 
_db.execSQL(DB_CREATE_CONFIG); 
_db.execSQL(DB_CREATE_SMS); 


// 初 始 化 系统 配置 的 数据 表 

Ix Config.LoadDefaultConfig(); 

ContentValues newValues = new ContentValues(); 
newValues.put(KEY CITY NAME, Ix Config.CityName); 
newValues.put(KEY REFRESH SPEED, Ix Config.RefreshSpeed); 
newValues.put(KEY SMS SERVICE, Ix Config.ProvideSmsService); 
newValues.put(KEY SMS INFO, Ix_Config.SaveSmsinfo); 
newValues.put(KEY KEY WORD, Ix Config.KeyWord); 
.db.insertDB TABLE CONFIG, null, newValues); 


} 


@Override 
public void onUpgrade(SQLiteDatabase db, int oldVersion, int. newVersion) ( 
_db.execSQL("DROP TABLE IF EXISTS "+ ОВ TABLE CONFIG); 
_db.execSQL("DROP TABLE IF EXISTS " + DB CREATE SMS); 
onCreate( db); 
b 
} 


系统 设置 界面 的 执行 效果 如 图 10-10 所 示 。 
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图 10-10 系统 设置 界面 的 执行 效果 


到 此 为 止 ， 本 章 智能 家 居 系统 全 部 介绍 完毕 。 有 关 本 实例 的 详细 源码 ， 请 读者 参阅 本 书 附带 光盘 


中 的 源码 。 
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第 11 章 健康 专家 一 一 智能 心率 计 


近 几 年 来 ， 各 大 科技 巨头 都 纷纷 推出 了 智能 可 穿戴 设备 。 随 着 人 们 对 新 技术 接受 度 的 提高 ， 可 穿 
戴 设备 必 将 成 为 未 来 人 们 生活 的 必需 品 之 一 。 开 发 可 穿戴 设备 需要 掌握 硬件 和 软件 技术 ， 因 为 本 书 讲 
解 的 是 Android 可 穿戴 技术 开发 ， 所 以 本 书 内 容 将 以 应 用 软件 程序 开发 为 主 。 在 本 章 的 内 容 中 ， 将 详 
细 讲 解 开发 Android 智能 心率 计 的 基本 知识 ， 为 步 入 本 书后 面 知识 的 学 习 打 下 基础 。 


11.1 什么 是 心率 


GEO 知识 点 讲解 光盘: 视频 \ 知 识 点 \ 第 11 章 \ 什 么 是 心率 .avi 

心率 (Heart Rate) 是 用 来 描述 心动 周期 的 专业 术语 ， 是 指 心脏 每 分 钟 跳动 的 次 数 ， 以 第 一 声音 为 
准 。 心 率 ， 现 代 汉 语 将 心率 解释 为 “心脏 跳动 的 频率 ”。 频 率 就 是 在 单位 时 间 内 ， 某 件 事情 发 生 的 
次 数 。 两 种 解释 合 起 来 就 是 ， 心 脏 在 一 定时 间 内 跳动 的 次 数 ， 也 就 是 在 一 定时 间 内 ， 心 脏 跳动 快慢 
的 意思 。 

据 科 学 研究 发 现 ， 正 常 成 年 人 安静 时 的 心率 有 显著 的 个 体 差异 ， 平 均 在 75 次 /分 左右 〈60 一 100 次 / 
分 之 间 )。 心 率 可 因 年龄 、 性 别 及 其 他 生理 情况 而 不 同 。 初 生 儿 的 心率 很 快 ， 可 达 130 次 /分 以 上 。 在 成 
年 人 中 ， 女 性 的 心率 一 般 比 男性 稍 快 。 同 一 个 人 ， 在 安静 或 睡眠 时 心率 减 慢 ， 运 动 时 或 情绪 激动 时 心率 
加 快 ， 在 某 些 药物 或 神经 体液 因素 的 影响 下 ， 会 使 心率 发 生 加 快 或 减 慢 。 经 常 进行 体力 劳动 和 体育 锻炼 
的 人 ， 平 时 心率 较 慢 。 近 年 ， 国 内 大 样本 健康 人 群 调查 发 现 ; 国人 男性 静 息 心 率 的 正常 范围 为 30 一 95 
次 /分 ， 女 性 为 5 一 95 次 /分 。 所 以 ， 心 率 随 年 龄 、 性 别 和 健康 状况 变化 而 变化 。 

健康 成 人 的 心率 为 60 一 100 次 /分 ， 大 多 数 为 60~80 次 /分 ， 女 性 稍 快 ; 3 岁 以 下 的 小 孩 常 在 100 
次 /分 以 上 ;老年 人 偏 慢 。 成 人 每 分 钟 心 率 超过 100 次 一 般 不 超过 160 次 /分 ) 或 婴 幼儿 超过 150 次 / 
分 者 ， 称 为 窦 性 心动 过 速 ， 常 见于 正常 人 运动 、 兴 奋 、 激 动 、 吸 烟 、 饮 酒 和 喝 浓 茶 后 ; 也 可 见于 发 
热 、 休 克 、 贫 血 、 甲 亢 、 心 力 衰竭 及 应 用 阿托品 、 肾 上 腺 素 、 麻 黄 素 等 。 如 果 心 率 在 160—220 次 / 
分 ， 常 称 为 阵 发 性 心动 过 速 。 心 率 低 于 60 次 /分 者 (一 般 在 40 次 /分 以 上 )， 称 为 窦 性 心动 过 缓 ， 可 
见于 长 期 从 事 重 体 力 劳 动 和 运动 员 ; 病理 性 的 见于 甲状 腺 机 能 低下 、 颅 内 压 增高 、 阻 塞 性 黄姜 ， 以 
及 洋 地 黄 、 奎 尼 丁 或 心得 安 类 药物 过 量 或 中 毒 。 如 心率 低 于 40 次 /分 ， 应 考虑 有 房 室 传导 阻 滞 。 心 率 
过 快 超过 160 次 /分 ， RETF 40 次 /分 ， 大 多 见于 心脏 病 病人 ， 病 人 常 有 心 怪 、 胸 间 、 心 前 区 不 适 ， 
应 及 早 进行 详细 检查 ， 以 便 针 对 病因 进行 治疗 。 心 脏 每 次 收缩 时 由 心室 向 动脉 输出 的 血 量 叫做 每 捕 
输出 量 ， 心 脏 每 分 钟 输出 的 血 量 叫做 每 分 输出 量 ， 正 常人 在 安静 状态 下 每 捕 输 出 量 为 70 毫升 ， 如 果 
心率 按 每 分 钟 75 次 计算 的 话 ， 每 分 输出 量 约 为 5250 毫升 。 心 输出 量 的 多 少 ， 是 衡量 心脏 工作 能 力 
的 一 项 指标 。 
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11.2 开发 一 个 Android 版 心率 计 


И 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 11 章 \ 开 发 一 个 Android 版 心率 计 .avi 


本 实例 的 功能 是 , 在 Android 系统 中 开发 一 个 心率 测试 应 用 程序 。 本 实例 是 通过 低 功 耗 蓝牙 (BLE) 
技术 来 检测 传感器 变化 的 ， 根 据 检测 到 的 变化 数据 来 测试 心率 的 变化 。 本 应 用 程序 实例 会 搜索 附近 的 
BLE 设备 ， 并 连接 到 远程 心脏 速率 传感器 的 服务 ， 会 监听 信号 平均 脉冲 ) 和 心脏 心率 的 变化 (心跳 
或 RR 数据 )， 并 且 能 够 检测 到 呼吸 率 如 何 影响 心脏 心率 变异 的 ， 并 根据 检测 结果 生成 三 维 图 形 演示 。 
在 本 实例 中 ， 使 用 BLE 技术 传输 心脏 速率 的 数据 。 因 为 具有 开放 的 协议 ， 所 以 可 以 较 快 地 建立 一 个 开 
发 环境 。 因 为 BLE 是 从 Android 4.3 开始 推出 的 ， 所 以 本 项 目 需要 运行 在 Android 4.3 的 设备 上 。 


11.2.1 扫描 蓝牙 设备 


本 系统 的 主 界面 Activity 是 DeviceScanActivity， 对 应 界面 布局 文件 是 actionbar_indeterminate_ 
progress.Xml， 有 具体 实现 代码 如 下 所 示 。 


<FrameLayout 
xmins:android="http://schemas.android.com/apk/res/android" 
android:layout_height="wrap_content" 
android:layout_width="56dp" 
android:minWidth="56dp"> 
<ProgressBar 
android:layout width-"32dp" 
android:layout_height="32dp" 
android:layout_gravity="center"/> 
</FrameLayout> 
通过 上 述 代码 ， 在 屏幕 中 显示 进度 控件 来 显示 当前 的 扫描 进度 。 
主 界面 Activity 的 实现 文件 是 DeviceScanActivity.java， 功 能 是 调用 UI 布局 文件 actionbar | 
indeterminate_progress.xml 加 载 显 示 的 控件 , 如 果 没 有 扫描 到 BLE 蓝牙 设备 则 输出 error_bluetooth_not_ 
supported 提示 ， 如 果 搜索 到 则 列表 显示 蓝牙 BLE 设备 。 文 件 DeviceScanActivity.java 的 具体 实现 代码 


如 下 所 示 。 
p 
* 扫 描 ， 并 显示 可 用 的 蓝牙 BLE 设备 
A 
public class DeviceScanActivity extends ListActivity { 


private static final int REQUEST_ENABLE_BT = 1; 
private static final long SCAN PERIOD = 500; 


private BleDevicesAdapter leDeviceListAdapter; 
private BluetoothAdapter bluetoothAdapter; 
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private Scanner scanner; 


@Override 
public void onCreate(Bundle savedinstanceState) { 


super.onCreate(savedinstanceState); 
getActionBar().setTitle(R.string.title_devices); 


/使 用 此 检查 ， 以 确定 BLE 是 否 支 持 在 设备 上 。 然 后 可 以 选择 性 地 禁用 BLE 相关 的 功能 

if (IgetPackageManager().hasSystemFeature(PackageManager.FEATURE BLUETOOTH LE)) ( 
Toast.makeText(this, R.string.ble not supported, Toast.LENGTH SHORT).show(); 
finish(); 
return; 


} 


/初始 化 一 个 蓝牙 适配器 。 对 于 АРІ 级 别 18 以 上 ， 通 过 BluetoothManager 得 到 一 个 BluetoothAdapter 
final BluetoothManager bluetoothManager = 

(BluetoothManager) getSystemService(Context.BLUETOOTH_SERVICE); 
bluetoothAdapter = bluetoothManager.getAdapter(); 


11 Checks if Bluetooth is supported on the device 

if (bluetoothAdapter == null) { 
Toast.makeText(this, R.string.error bluetooth not supported, Toast.LENGTH SHORT).show(); 
finish(); 
return; 


@Override 
public boolean onCreateOptionsMenu(Menu menu) { 


getMenulnflater().inflate(R.menu.gatt scan, menu); 

if (scanner == null || !scanner.isScanning()) { 
menu.findltem(R.id.menu stop).setVisible(false); 
menu.findltem(R.id.menu scan).setVisible(true); 
menu.findltem(R.id.menu refresh).setActionView(null); 

}else { 
menu.finditem(R.id.menu_stop).setVisible(true); 
menu.findltem(R.id.menu scan).setVisible(false); 
menu.findltem(R.id.menu refresh).setActionView( 

R.layout.actionbar indeterminate progress); 
) 


return true; 


) 
/根据 监 听 到 的 用 户 操作 执行 对 应 的 事件 处 理 程序 
@Override 
public boolean onOptionsltemSelected(Menultem item) { 


switch (item.getltemld()) { 
case R.id.menu_scan: 
leDeviceListAdapter.clear(); 
if (Scanner == null) { 
scanner = new Scanner(bluetoothAdapter, mLeScanCallback); 
scanner.startScanning(); 


invalidateOptionsMenu(); 
} 
break; 
case R.id.menu_stop: 
if (scanner != null) { 
scanner.stopScanning(); 
scanner = null; 


invalidateOptionsMenu(); 
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If Bluetooth is not currently enabled, 


II fire an intent to display a dialog asking the user to grant permission to enable it 


final Intent enableBtIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE); 


} 
break; 
} 
return true; 
} 
@Override 
protected void onResume() { 
super.onResume(); 
11 Ensures Bluetooth is enabled on the device. 
if (IbluetoothAdapter.isEnabled()) ( 
startActivityForResult(enableBtIntent, REQUEST ENABLE BT); 
return; 
) 
init(); 
} 
@Override 


protected void onActivityResult(int requestCode, int resultCode, Intent data) { 


/ User chose not to enable Bluetooth 


if (requestCode == REQUEST. ENABLE BT)( 
if (resultCode == Activity. RESULT CANCELED) { 


finish(); 
) else { 
init(); 
} 
} 


super.onActivityResult(requestCode, resultCode, data); 


} 
/| 暂停 扫描 
@Override 
protected void onPause() { 
super.onPause(); 


if (scanner != null) { 
scanner.stopScanning(); 
scanner = null; 
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} 


} 
/监听 用 户 单 击 操作 命令 选项 事件 
@Override 
protected void onListltemClick(ListView |, View v, int position, long id) í 
final BluetoothDevice device = leDeviceListAdapter.getDevice(position); 
if (device == null) 
return; 


final Intent intent = new Intent(this, DeviceServicesActivity.class); 
intent. putExtra(DeviceServicesActivity.EXTRAS DEVICE NAME, device.getName()); 
intent.putExtra(DeviceServicesActivity.EXTRAS DEVICE ADDRESS, device.getAddress()); 
startActivity(intent); 

} 


private void init() { 
if (leDeviceListAdapter == null) { 
leDeviceListAdapter = new BleDevicesAdapter(getBaseContext()); 
setListAdapter(leDeviceListAdapter); 
} 


if (Scanner == null) { 
scanner = new Scanner(bluetoothAdapter, mLeScanCallback); 


scanner.startScanning(); 
} 
invalidateOptionsMenu(); 
} 
11 扫描 设备 回调 


private BluetoothAdapterLeScanCallback mLeScanCallback = 
new BluetoothAdapterLeScanCallback(){ 


@Override 
public void onLeScan(final BluetoothDevice device, final int rssi, byte[ ] scanRecord) ( 
runOnUiThread(new Runnable() { 
@Override 
public void run() { 
leDeviceListAdapter.addDevice(device, rssi); 
leDeviceListAdapter.notifyDataSetChanged(); 


}); 


private static class Scanner extends Thread { 
private final BluetoothAdapter bluetoothAdapter; 
private final BluetoothAdapter.LeScanCallback mLeScanCallback; 


private volatile boolean isScanning = false; 


mus eese—_seced ОООО 


Scanner(BluetoothAdapter adapter, BluetoothAdapter.LeScanCallback callback) { 
bluetoothAdapter = adapter; 
mLeScanCallback = callback; 

} 


public boolean isScanning() { 
return isScanning; 


} 
public void startScanning() { 
synchronized (this) { 
isScanning = true; 
start(); 
} 
} 
public void stopScanning() { 
synchronized (this) { 
isScanning = false; 
bluetoothAdapter.stopLeScan(mLeScanCallback); 
} 
} 
@Override 
public void run() { 
ty{ 
while (true){ 
synchronized (this) { 
if (isScanning) 
break; 
bluetoothAdapter.startLeScan(mLeScanCallback); 
} 
sleep(SCAN_PERIOD); 
synchronized (this) { 
bluetoothAdapter.stopLeScan(mLeScanCallback); 
} 
} 
} catch (InterruptedException ignore) { 
} finally { 
bluetoothAdapter.stopLeScan(mLeScanCallback); 
} 
} 


} 
} 
通过 上 述 代 码 可 知 ， 在 扫描 过 程 中 可 以 控制 扫描 操作 ， 方 法 是 单 击 设备 右上 角 的 stop. scan 按钮 。 
执行 效果 如 图 11-1 所 示 。 


®) 
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图 11-1 扫描 到 的 蓝牙 BLE 设备 列表 
11.2.2 ”蓝牙 控制 界面 


在 主 界面 中 列表 显示 扫描 到 的 蓝牙 BLE 设备 列表 ， 单 击 列表 中 的 某 一 个 蓝牙 设备 后 会 来 到 蓝牙 控 
制 界 面 ， 在 此 界面 可 以 设置 和 这 个 蓝牙 设备 的 连接 及 断 开 连 接 操 作 ， 并 显示 蓝牙 设备 的 GAP 和 GATT 
信息 。 蓝 牙 控制 界面 的 UI 布局 文件 是 gatt_services_characteristics.xml， 有 具体 实现 代码 如 下 所 示 。 

<LinearLayout 

xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:paddingTop-"10dp"» 
«LinearLayout 
android:orientation-"horizontal" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:paddingLeft-"10dp" 
android:paddingRight="10dp"> 
<TextView 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:text-"(g'string/label device address" 
android:textAppearance="?android:textAppearanceMedium" 
android:layout_marginRight="5dp"/> 
<TextView 


[ON 
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android:id="@+id/device_address" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:textAppearance="?android:textAppearanceMedium"/> 
</LinearLayout> 
<LinearLayout 
android:orientation-"horizontal" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:paddingLeft-"10dp" 
android:paddingRight="10dp"> 
<TextView 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:textAppearance="?android:textAppearanceMedium" 
android:text="@string/label_ state" 
android:layout_marginRight="5dp"/> 
<TextView 
android:id="@+id/connection_ state" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:textAppearance-"?android:textAppearanceMedium"/» 
</LinearLayout> 
<LinearLayout 
android:orientation-"horizontal" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:paddingLeft="10dp" 
android:paddingRight="10dp"> 
<TextView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:textAppearance="?android:textAppearanceMedium" 
android:text="@string/label_data" 
android:layout_marginRight="5dp"/> 
<TextView 
android:id="@+id/data_value" 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:textAppearance="?android:textAppearanceMedium" 
android:text="@string/no_data" 
android:minLines="3"/> 
</LinearLayout> 
<LinearLayout 
android:orientation="horizontal" 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:paddingLeft="10dp" 
android:paddingRight="10dp"> 
<TextView 
android:layout_width="wrap_content" 
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android:layout height-"wrap content" 
android:textAppearance-"?android:textAppearanceMedium" 
android:text="@string/label_heartrate" 
android:layout_marginRight="5dp"/> 
<TextView 
android:id="@+id/heartrate_value" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:textAppearance="?android:textAppearanceMedium" 
android:text="@string/no_data" 
android:minLines="1"/> 
</LinearLayout> 
<LinearLayout 
android:orientation-"horizontal" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:paddingLeft="10dp" 
android:paddingRight="10dp"> 
<Button 
android:id="@+id/demo" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="@string/action_demo" 
android:clickable="false" 
android:focusable="false" /> 
</LinearLayout> 
<TextView 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:text-"(gstring/label services" 
android:paddingTop-"4dp" 
android:paddingBottom="4dp" 
android:paddingLeft="10dp" 
android:paddingRight="10dp" 
android:textStyle="bold" 
android:textAppearance="?android:textAppearanceMedium" 
android:background="@android:drawable/divider_horizontal_bright" /> 
<ExpandableListView 
android:id="@+id/gatt_services list" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:groupIndicator="@null"/> 
</LinearLayout> 
蓝牙 控制 界面 的 程序 文件 是 DeviceServicesActivity,java， 功 能 是 调用 UI 文件 中 的 布局 控件 ， 并 根 
据 用 户 所 选 的 蓝牙 BLE 设备 提供 连接 和 显示 数据 界面 ， 并 显示 设备 支持 的 GATT 服务 和 特性 ， 并 且 通 
过 此 BleService 服务 ， 可 以 实现 与 蓝牙 BLE 的 API 实现 交互 通信 功能 。 
文件 DeviceServicesActivity.java 的 具体 实现 代码 如 下 所 示 。 
public class DeviceServicesActivity extends Activity { 
private final static String TAG = DeviceServicesActivity.class.getSimpleName(); 


6. 
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public static final String EXTRAS DEVICE. NAME = "DEVICE. МАМЕ"; 
public static final String EXTRAS DEVICE ADDRESS = "DEVICE ADDRESS"; 


private TextView connectionState; 
private TextView dataField; 
private TextView heartRateField; 
private TextView intervalField; 
private Button demoButton; 


private ExpandableListView gattServicesList; 
private BleServicesAdapter gattServiceAdapter; 


private String deviceName; 

private String deviceAddress; 
private BleService bleService; 
private boolean isConnected = false; 


private BleSensor<?> activeSensor; 
private BleSensor«?» heartRateSensor; 


private OnServiceltemClickListener serviceListener; 


// 代 码 管理 服务 的 生命 周期 


private final ServiceConnection serviceConnection = new ServiceConnection() { 


@Override 
public void onServiceConnected(ComponentName componentName, IBinder service) { 
bleService = ((BleService.LocalBinder) service).getService(); 
if (IpleService.initialize()) ( 
Log.e(TAG, "Unable to initialize Bluetooth"); 
finish(); 
} 
11 Automatically connects to the device upon successful start-up initialization. 
bleService.connect(deviceAddress); 
} 


@Override 
public void onServiceDisconnected(ComponentName componentName) { 
bleService = null; 
} 
Y: 


// 处 理 蓝牙 发 射 服务 中 的 常见 活动 

/ACTION_GATT_CONNECTED: 连接 一 个 GATT 服务 

П ACTION_GATT_DISCONNECTED: 断 开 一 个 GATT 服务 连接 

II ACTION GATT SERVICES DISCOVERED: 发 现 一 个 GATT 服务 

1 ACTION DATA AVAILABLE: received data from the device. This can be a result of read 
I or notification operations 


a 
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private final BroadcastReceiver gattUpdateReceiver = new BroadcastReceiver() { 
@Override 
public void onReceive(Context context, Intent intent) { 

final String action = intent.getAction(); 

if (BleService. ACTION_GATT_CONNECTED.equals(action)) { 
isConnected = true; 
updateConnectionState(R.string.connected); 
invalidateOptionsMenu(); 

} else if (BleService. ACTION_GATT_DISCONNECTED.equals(action)) { 
isConnected = false; 
updateConnectionState(R.string.disconnected); 
invalidateOptionsMenu(); 
clearUI(); 

} else if (BleService. ACTION GATT SERVICES DISCOVERED.equals(action)) { 
11 Show all the supported services and characteristics on the user interface. 
displayGattServices(bleService.getSupportedGattServices()); 

enableHeartRateSensor(); 
} else if (BleService. ACTION DATA AVAILABLE.equals(action)) { 
displayData(intent.getStringExtra(BleService.EXTRA_SERVICE_UUID), 
intent.getStringExtra(BleService.EXTRA_TEXT)); 


} 
} 


/如果 给 定 了 一 个 GATT 服务 选项 ， 请 检查 它 对 应 的 支持 功能 ， 具 体 请 参考 http://d.android.com/reference/ 
android/bluetooth/BluetoothGatt.html 列 出 的 支持 的 特性 功能 列表 
private final ExpandableListView.OnChildClickListener servicesListClickListner = 
new ExpandableListView.OnChildClickListener() { 
@Override 
public boolean onChildClick(ExpandableListView parent, View v, int groupPosition, 
int childPosition, long id) { 
if (gattServiceAdapter == null) 
return false; 
final BluetoothGattCharacteristic characteristic = gattServiceAdapter.getChild(groupPosition, 
childPosition); 
final BleSensor<?> sensor = BleSensors.getSensor(characteristic. getService().getUuid(). 
toString()); 
if (activeSensor != null) 
bleService.enableSensor(activeSensor, false); 
if (sensor == null) { 
bleService.readCharacteristic(characteristic); 


return true; 

} 

if (sensor == activeSensor) 
return true; 


activeSensor = sensor; 
bleService.enableSensor(sensor, true); 
return true; 
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} 
y: 
private final BleServicesAdapter.OnServiceltemClickListener demoClickListener = new BleServicesAdapter. 
OnServiceltem ClickListener() { 
@Override 
public void onDemoClick(BluetoothGattService service) { 
Log.d(TAG, "onDemoClick: service" +service.getUuid().toString()); 
final BleSensor<?> sensor = BleSensors.getSensor(service.getUuid().toString()); 
if (sensor == null) 
return; 
final Class<? extends DemoSensorActivity> demoClass; 
if (sensor instanceof BleHeartRateSensor) 
demoClass = DemoHeartRateSensorActivity.class; 
else 
return; 
final Intent demolntent = new Intent(); 
demolntent.setClass(DeviceServicesActivity.this, demoClass); 
demolntent.putExtra(DemoSensorActivity.EXTRAS DEVICE ADDRESS, deviceAddress); 
demolntent.putExtra(DemoSensorActivity. EXTRAS SENSOR UUID, service.getUuid().toString()); 
startActivity(demolntent); 
) 
@Override 
public void onServiceEnabled(BluetoothGattService service, boolean enabled) { 
if (gattServiceAdapter == null) 
return; 
final BleSensor<?> sensor = BleSensors.getSensor(service.getUuid().toString()); 
if (sensor == null) 
return; 
if (sensor == activeSensor) 
return; 
if (activeSensor != null) 
bleService.enableSensor(activeSensor, false); 
activeSensor = sensor; 
bleService.enableSensor(sensor, true); 
} 
@Override 
public void onServiceUpdated(BluetoothGattService service) { 
final BleSensor<?> sensor = BleSensors.getSensor(service.getUuid().toString()); 
if (sensor == null) 
return; 
bleService.updateSensor(sensor); 
} 
Б 
private void clearUI() { 
gattServicesList.setAdapter((SimpleExpandableListAdapter) null); 
dataField.setText(R.string.no_data); 
heartRateField.setText(R.string.no_data); 
intervalField.setText(R.string.no data); 


E Android 外 设 开发 实战 


public void setServiceListener(OnServiceltemClickListener listener) { 
this.serviceListener = listener; 
} 
@Override 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.gatt services characteristics); 
final Intent intent = getIntent(); 
deviceName = intent.getStringExtra(EXTRAS DEVICE МАМЕ); 
deviceAddress = intent.getStringExtra(EXTRAS DEVICE ADDRESS); 
I| 设置 用 户 界面 
((TextView) findViewByld(R.id.device_address)).setText(deviceAddress); 
gattServicesList = (ExpandableListView) findViewByld(R.id.gatt services list); 
gattServicesList.setOnChildClickListener(servicesListClickListner); 
connectionState = (TextView) findViewByld(R.id.connection_state); 
dataField = (TextView) findViewByld(R.id.data_value); 
heartRateField = (TextView) findViewByld(R.id.heartrate value); 
demoButton = (Button) findViewByld(R.id.demo); 
demoButton.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
Log.d(TAG, "onClick serviceListener: "+serviceListener); 
if (serviceListener == null) 
retum; 
final BluetoothGattService service = gattServiceAdapter.getHeartRateService(); 
serviceListener.onDemoClick(service); 
Log.d(TAG, "set service listener"); 
} 


}; 
demoButton.setVisibility(View.VISIBLE); 


getActionBar().setTitle(deviceName); 
getActionBar().setDisplayHomeAsUpEnabled(true); 

final Intent gattServicelntent = new Intent(this, BleService.class); 
bindService(gattServicelntent, serviceConnection, BIND AUTO CREATE); 


} 
@Override 
protected void onResume() { 
super.onResume(); 
registerReceiver(gattUpdateReceiver, makeGattUpdatelntentFilter()); 
if (bleService != null) { 
final boolean result = bleService.connect(deviceAddress); 
Log.d(TAG, "Connect request result=" + result); 
} 
} 
@Override 
protected void onPause() { 
super.onPause(); 


unregisterReceiver(gattUpdateReceiver); 


@ 
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} 
@Override 
protected void onDestroy() { 
super.onDestroy(); 
unbindService(serviceConnection); 
bleService = null; 
} 
@Override 
public boolean onCreateOptionsMenu(Menu menu) { 
getMenulnflater().inflate(R.menu.gatt services, menu); 
if (isConnected) ( 
menu.findltem(R.id.menu connect).setVisible(false); 
menu.findltem(R.id.menu disconnect).setVisible(true); 
) else { 
menu.findltem(R.id.menu_connect).setVisible(true); 
menu.findltem(R.id.menu_disconnect).setVisible(false); 


) 
return true; 
) 
// 根 据 用 户 选择 设置 连接 状态 
@Override 
public boolean onOptionsltemSelected(Menultem item) { 
switch(item.getltemld()) { 
case R.id.menu_connect: 
bleService.connect(deviceAddress); 
return true; 
case R.id.menu_disconnect: 
bleService.disconnect(); 
return true; 
case android.R.id.home: 
onBackPressed(); 
return true; 
} 


return super.onOptionsltemSelected(item); 


} 
// 更 新 连接 状态 
private void updateConnectionState(final int resourceld) { 
runOnUiThread(new Runnable() { 
@Override 
public void run() { 
connectionState.setText(resourceld); 


} 
D 
} 
// 显 示 数 据 
private void displayData(String иша, String data) { 
if (data != null) { 


if (uuid.equals(BleHeartRateSensor.getServiceUUIDString())) { 


heartRateField.setText(data); 
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) else ( 
dataField.setText(data); 
) 
} 
} 
private boolean enableHeartRateSensor() { 
if (gattServiceAdapter == null) 
return false; 
final BluetoothGattCharacteristic characteristic = gattServiceAdapter 
.getHeartRateCharacteristic(); 
Log.d(TAG, "characteristic: " + characteristic); 
final BleSensor<?> sensor = BleSensors.getSensor(characteristic 
.getService() 
.getUuid() 
-toString()); 
if (heartRateSensor != null) 
bleService.enableSensor(heartRateSensor, false); 
if (sensor == null) ( 
bleService.readCharacteristic(characteristic); 


return true; 

} 

if (sensor == heartRateSensor) 
return true; 


heartRateSensor = sensor; 
bleService.enableSensor(sensor, true); 


this.setServiceListener(demoClickListener); 
return true; 


} 


private void displayGattServices(List<BluetoothGattService> gattServices) { 

if (gattServices == null) 
return; 

gattServiceAdapter = new BleServicesAdapter(this, gattServices); 
gattServiceAdapter.setServiceListener(demoClickListener); 
gattServicesList.setAdapter(gattServiceAdapter); 

} 

private static IntentFilter makeGattUpdatelntentFilter() { 
final IntentFilter intentFilter = new IntentFilter(); 
intentFilter.addAction(BleService. ACTION GATT CONNECTED); 
intentFilter.addAction(BleService.ACTION GATT DISCONNECTED); 
intentFilter.addAction(BleService. ACTION GATT SERVICES DISCOVERED); 
intentFilter.addAction(BleService.ACTION DATA AVAILABLE); 
return intentFilter; 

} 

} 


在 上 述 代码 中 ， 可 以 控制 当前 设备 的 连接 状态 ， 此 功能 是 通过 文件 BleServicejava 实现 的 ， 


实现 代码 如 下 所 示 。 
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p 
* 服 务 管理 连接 ， 并 与 托管 给 定 的 蓝牙 BLE 设备 上 的 GATT 服务 器 进行 数据 通信 
9! 
public class BleService extends Service { 
private final static String TAG = BleService.class.getSimpleName(); 


private BluetoothManager bluetoothManager; 

private BluetoothAdapter adapter; 

private String deviceAddress; 

private BluetoothGatt gatt; 

private int connectionState = STATE DISCONNECTED; 


private static final int STATE_DISCONNECTED = 0; 
private static final int STATE_CONNECTING = 1; 
private static final int STATE_CONNECTED = 2; 


private final static String INTENT_PREFIX = BleService.class.getPackage().getName(); 

public final static String ACTION GATT CONNECTED = INTENT_PREFIX+" ACTION GATT CONNECTED"; 
public final static String ACTION GATT DISCONNECTED = INTENT PREFIX+".ACTION GATT 
DISCONNECTED"; 

public final static String ACTION_GATT_SERVICES_DISCOVERED = INTENT_PREFIX+".ACTION_ 
GATT_ SERVICES DISCOVERED"; 

public final static String ACTION DATA AVAILABLE = INTENT_PREFIX+".ACTION_DATA_AVAILABLE"; 
public final static String EXTRA SERVICE UUID = INTENT PREFIX*".EXTRA SERVICE UUID"; 
public final static String EXTRA CHARACTERISTIC ОШО = INTENT PREFIX*".EXTRA CHARA 
CTERISTIC ЏИЛ"; 

public final static String EXTRA DATA = INTENT PREFIX*".EXTRA DATA"; 

public final static String EXTRA TEXT = INTENT PREFIX*".EXTRA ТЕХТ"; 


/实现 回调 方法 ， 用 于 处 理 GATT 事件 的 应 用 程序 ， 例 如 ， 连 接 变 化 和 发 现 服务 


private final BluetoothGattExecutor executor = new BluetoothGattExecutor() { 


@Override 
public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) { 
super.onConnectionStateChange(gatt, status, newState); 


String intentAction; 

if (newState == BluetoothProfile.STATE CONNECTED) { 
intentAction = ACTION GATT CONNECTED; 
connectionState = STATE_CONNECTED; 
broadcastUpdate(intentAction); 

Log.i(TAG, "Connected to GATT server."); 

// 连接 成 功 后 试图 发 现 服务 

Log.i(TAG, "Attempting to start service discovery:" + 
BleService.this.gatt.discoverServices()); 

} else if (newState == BluetoothProfile.STATE DISCONNECTED) { 
intentAction - ACTION GATT DISCONNECTED; 
connectionState - STATE DISCONNECTED; 
Log.i(TAG, "Disconnected from GATT server."); 
broadcastUpdate(intentAction); 
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} 


@Override 
public void onServicesDiscovered(BluetoothGatt gatt, int status) { 
super.onServicesDiscovered(gatt, status); 


if (status == BluetoothGatt.GATT_SUCCESS) { 
broadcastUpdate(ACTION GATT SERVICES DISCOVERED); 
) else { 
Log.w(TAG, "onServicesDiscovered received: " + status); 
} 
} 


@Override 
public void onCharacteristicRead(BluetoothGatt gatt, 
BluetoothGattCharacteristic characteristic, 
int status) { 
super.onCharacteristicRead(gatt, characteristic, status); 


if (status == BluetoothGatt.GATT_SUCCESS) { 
final BleSensor<?> sensor = BleSensors.getSensor(characteristic. getService().getUuid().toString()); 
if (sensor != null) { 
if (sensor.onCharacteristicRead(characteristic)) { 


return; 
} 
} 
broadcastUpdate(ACTION_DATA_AVAILABLE, characteristic); 
} 
} 
@Override 


public void onCharacteristicChanged(BluetoothGatt gatt, 
BluetoothGattCharacteristic characteristic) { 
super.onCharacteristicChanged(gatt, characteristic); 


broadcastUpdate(ACTION_DATA_AVAILABLE, characteristic); 
k 


private void broadcastUpdate(final String action) ( 
final Intent intent = new Intent(action); 
sendBroadcast(intent); 


} 


private void broadcastUpdate(final String action, 
final BluetoothGattCharacteristic characteristic) { 
final Intent intent = new Intent(action); 
intent.putExtra(EXTRA_SERVICE_UUID, characteristic.getService().getUuid().toString()); 
intent.putExtra(EXTRA CHARACTERISTIC UUID, characteristic.getUuid().toString()); 


@ 
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final BleSensor<?> sensor = BleSensors.getSensor(characteristic.getService().getUuid().toString()); 
if (sensor != null) { 
sensor.onCharacteristicChanged(characteristic); 
final String text = sensor.getDataString(); 
intent.putExtra(EXTRA_TEXT, text); 
sendBroadcast(intent); 
) else { 
// 对 于 其 他 的 配置 文件 ， 写 入 十 六 进 制 格式 的 数据 
final byte[ ] data = characteristic.getValue(); 
if (data != null && data.length > 0) { 
final StringBuilder stringBuilder = new StringBuilder(data.length); 
for (byte byteChar : data) 
stringBuilder.append(String.format("%02X ", byteChar)); 
intent.putExtra(EXTRA_TEXT, new String(data) + "n" + stringBuilder.toString()); 
} 
} 
sendBroadcast(intent); 


} 


public class LocalBinder extends Binder { 
public BleService getService() { 
return BleService.this; 
} 
} 


@Override 
public IBinder onBind(Intent intent) { 
return mBinder; 


} 


@Override 
public boolean onUnbind(Intent intent) { 
/使 用 给 定 的 设备 后 ， 你 应 该 确保 BluetoothGatt.close() 被 调用 ， 这 样 可 以 正确 清理 资源 。 在 这 个 特定 的 例子 
中 ， 当 UI 是 断 开 服务 时 调用 close() 
close(); 
return super.onUnbind(intent); 


} 


pt 
* 启 用 或 禁用 对 一 个 给 特性 的 通知 


* @param sensor 
* @param enabled If true, enable notification. False otherwise. 
ш 
public void enableSensor(BleSensor<?> sensor, boolean enabled) { 
if (sensor == null) 
return; 


if (adapter == null || gatt == null) { 
Log.w(TAG, "BluetoothAdapter not initialized"); 
return; 
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} 


executor.enable(sensor, enabled); 
executor.execute(gatt); 


} 
private final IBinder mBinder = new LocalBinder(); 


pr 
“初始 化 一 个 引用 到 本 地 蓝牙 适配器 


* @return Retum true if the initialization is successful. 
di 
public boolean initialize() { 
II For API level 18 and above, get a reference to BluetoothAdapter through 
II BluetoothManager 
if (bluetoothManager == null) ( 
bluetoothManager = (BluetoothManager) getSystemService(Context.BLUETOOTH SERVICE); 
if (bluetoothManager == null) { 
Log.e(TAG, "Unable to initialize BluetoothManager."); 
return false; 


} 


adapter = bluetoothManager.getAdapter(); 

if (adapter == null) { 
Log.e(TAG, "Unable to obtain a BluetoothAdapter."); 
return false; 


} 


return true; 


} 


p 
* 连 接 到 托管 蓝牙 BLE 设备 上 的 GATT 服务 器 


* @рагат address The device address of the destination device. 
* @return Return true if the connection is initiated successfully. The connection result 
i is reported asynchronously through the 
Ы {@code BluetoothGattCallback#onConnectionStateChange(android. bluetooth BluetoothGatt, int, int)} 
s callback. 
si 
public boolean connect(final String address) ( 
if (adapter == null || address == null) ( 
Log.w(TAG, "BluetoothAdapter not initialized or unspecified address."); 
return false; 


} 


// 前 面 连接 的 设备 。 尝 试 重 新 连接 
if (deviceAddress != null && address.equals(deviceAddress) 
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&& gatt != null) { 
Log.d(TAG, "Trying to use an existing BluetoothGatt for connection."); 
if (gatt.connect()) { 
connectionState - STATE CONNECTING; 
return true; 
) else { 
return false; 
} 
} 


final BluetoothDevice device = adapter.getRemoteDevice(address); 
if (device == null) { 

Log.w(TAG, "Device not found. Unable to connect."); 

return false; 


) 

// 因 为 要 直接 连接 到 设备 上 ， 所 以 我 们 设置 了 自动 连接 ， 参 数 设置 为 false 
gatt = device.connectGatt(this, false, executor); 

Log.d(TAG, "Trying to create a new connection."); 

deviceAddress = address; 

connectionState = STATE_CONNECTING; 

return true; 


} 


p 
* 断 开 现 有 连接 或 取消 一 个 挂 起 的 连接 。 断 线 结果 
* 通 过 异步 
* {@code BluetoothGattCallback#onConnectionStateChange(android.bluetooth.BluetoothGatt, int, int)} 
* 回调 
«fl 
public void disconnect() { 
if (adapter == null || gatt == null) ( 
Log.w(TAG, "BluetoothAdapter not initialized"); 
return; 
) 
gatt.disconnect(); 
} 


p 
* 使 用 给 定 的 BLE 设备 后 ， 应 用 程序 必须 调用 此 方法 ， 以 确保 资源 被 正确 释放 
4 
public void close() ( 
if (gatt == null) ( 
return; 
) 
gatt.close(); 
даќ = null; 
} 
n 
* 读 取 一 个 给 定 的 {@code BluetoothGattCharacteristic). 读 取 结果 通过 异步 
*{@code BluetoothGattCallback#onCharacteristicRead(android.bluetooth.BluetoothGatt, android.bluetooth. 
Bluetooth GattCharacteristic, їпї)} 回调 


E 
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* 


* @param characteristic The characteristic to read from. 
Hi 
public void readCharacteristic(BluetoothGattCharacteristic characteristic) { 
if (adapter == null || gatt == null) { 
Log.w(TAG, "BluetoothAdapter not initialized"); 
return; 
H 
gatt.readCharacteristic(characteristic); 
} 
public void updateSensor(BleSensor<?> sensor) ( 
if (Sensor == null) 
return; 
if (adapter == null || gatt == null) { 
Log.w(TAG, "BluetoothAdapter not initialized"); 
return; 
} 
executor.update(sensor); 
executor.execute(gatt); 
} 
p 
* 检 索 连 接 的 设备 上 支持 关 GATT 服务 列表 
* @return A {@code List} of supported services. 
fl 
public List<BluetoothGattService> getSupportedGattServices() { 
if (gatt == null) return null; 
return gatt.getServices(); 
} 
} 
在 上 述 代码 中 , 通过 文件 BluetoothGattExecutorjava 实现 了 蓝牙 GATT 服务 的 具体 操作 , 具体 实现 
代码 如 下 所 示 。 
public class BluetoothGattExecutor extends BluetoothGattCallback { 
public interface ServiceAction { 
public static final ServiceAction NULL = new ServiceAction() { 
@Override 
public boolean execute(BluetoothGatt bluetoothGatt) { 
II it is null action. do nothing. 
return true; 


y: 
p 
* 执行 操作 
* @рагат bluetoothGatt 
* @return true - if action was executed instantly. false if action is waiting for 
* feedback. 
Ji 
public boolean execute(BluetoothGatt bluetoothGatt); 
} 
private final LinkedList<BluetoothGattExecutor.ServiceAction> queue = new LinkedList<ServiceAction>(); 
private volatile ServiceAction currentAction; 


@ 
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public void update(final BleSensor sensor) ( 
queue.add(sensor.update()); 
} 
public void enable(BleSensor sensor, boolean enable) { 
final ServiceAction[ ] actions = sensor.enable(enable); 
for ( ServiceAction action : actions ) { 
this.queue.add(action); 
} 
} 
public void execute(BluetoothGatt gatt) { 
if (currentAction != null) 
return; 
boolean next = !queue.isEmpty(); 
while (next) { 
final BluetoothGattExecutor.ServiceAction action = queue.pop(); 
currentAction = action; 
if (laction.execute(gatt)) 
break; 
currentAction = null; 
next = !queue.isEmpty(); 
} 
} 
@Override 
public void onDescriptorWrite(BluetoothGatt gatt, BluetoothGattDescriptor descriptor, int status) { 
super.onDescriptorWrite(gatt, descriptor, status); 
currentAction = null; 
execute(gatt); 
) 
@Override 
public void onCharacteristicWrite(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) { 
super.onCharacteristicWrite(gatt, characteristic, status); 
currentAction = null; 
execute(gatt); 
) 
@Override 
public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) { 
if (newState == BluetoothProfile.SSTATE DISCONNECTED) { 
queue.clear(); 
} 
} 
@Override 
public void onCharacteristicRead(BluetoothGatt gatt, 
BluetoothGattCharacteristic characteristic, 
int status) { 
currentAction = null; 
execute(gatt); 
} 
} 


蓝牙 设置 界面 执行 效果 如 图 11-2 所 示 。 
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Polar H6 503F7716 DISCONNECT 


Device address: 00;22:00:50:3F:77 
State: Connected 
Data: Polar H6 503F7716 

50 GF 6С 61 72 20 48 36 20 35 30 33 46 37 37 31 36 


Heart rate: heart rate=57.0 
interval-1035.0 
Demo 
Services. 
GAP Service. 
00001800 0000-1000 8000 00805f9b34fh 
GATT Service 
Heart rate. 


Device Information. 


Unknown 
80:000010 


Unknown 
6217849 fb31.1140ad5s-a45545dTecf 


图 11-2 “ 某 个 蓝牙 设备 的 控制 界面 
11.2.3 蓝牙 BLE 设备 适配器 


在 前 面 11.2.2 的 内 容 中 用 到 了 蓝牙 BLE 设备 适配器 功能 ， 通 过 适配器 列表 显示 了 当前 扫描 到 的 蓝 
A BLE 设备 。 蓝 牙 BLE 设备 适配器 的 布局 文件 是 listitem_device.xml， 有 具体 实现 代码 如 下 所 示 。 
<RelativeLayout 
xmins:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:paddingTop-"4dp" 
android:paddingBottom="4dp" 
android:paddingRight="10dp" 
android: paddingLeft="10dp"> 
<TextView 
android:id="@+id/device_rssi" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout alignParentRight-"true" 
android:layout centerVertical-"true"/» 


«LinearLayout 
android:orientation-" vertical" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:layout_toLeftOf="@id/device_rssi"> 


310 


gus exse—_seced ОООО 


<TextView 
android:id="@+id/device_name" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:textAppearance="?android:textAppearanceMedium" 
android:textStyle="bold"/> 
<TextView 
android:id="@tid/device_address" 
android:layout width-"match parent" 
android:layout height-"wrap content"/» 


</LinearLayout> 
</RelativeLayout> 
对 应 的 程序 文件 是 BleDevicesAdapterjava， 功 能 是 扫描 附近 的 BLE 蓝牙 设备 ， 具 体 实现 代码 如 下 


所 示 。 
public class BleDevicesAdapter extends BaseAdapter { 
private final Layoutinflater inflater; 


private final ArrayList<BluetoothDevice> leDevices; 
private final HashMap<BluetoothDevice, Integer» rssiMap = new HashMap<BluetoothDevice, Integer>(); 


public BleDevicesAdapter(Context context) { 
leDevices = new ArrayList<BluetoothDevice>(); 
inflater = Layoutinflater.from(context); 


} 


public void addDevice(BluetoothDevice device, int rssi) { 
if (lleDevices.contains(device)) ( 
leDevices.add(device); 
} 
rssiMap.put(device, rssi); 


} 


public BluetoothDevice getDevice(int position) { 
return leDevices.get(position); 


} 


public void clear() { 
leDevices.clear(); 


} 


@Override 
public int getCount() { 
return leDevices.size(); 


} 


@Override 
public Object getltem(int i) { 
return leDevices.get(i); 


} 
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@Override 
public long getltemld(int i) { 
return i; 


} 


@Override 
public View getView(int i, View view, ViewGroup viewGroup) { 
ViewHolder viewHolder; 
/一般 列表 视图 的 优化 代码 
if (view == null) { 
view = inflater.inflate(R.layout.listitem device, null); 
viewHolder = new ViewHolder(); 
viewHolder.deviceAddress = (TextView) view.findViewByld(R.id.device_address); 
viewHolder.deviceName = (TextView) view.findViewByld(R.id.device_name); 
viewHolder.deviceRssi = (TextView) view.findViewByld(R.id.device_rssi); 
view.setTag(viewHolder); 
) else { 
viewHolder = (ViewHolder) view.getTag(); 
} 


BluetoothDevice device = leDevices.get(i); 

final String deviceName = device.getName(); 

if (deviceName != null && deviceName.length() > 0) 
viewHolder.deviceName.setText(deviceName); 

else 
viewHolder.deviceName.setText(R.string.unknown_device); 

viewHolder.deviceAddress.setText(device.getAddress()); 

viewHolder.deviceRssi.setText(""+rssiMap.get(device)+" dBm"); 


return view; 

} 

private static class ViewHolder { 
TextView deviceName; 
TextView deviceAddress; 
TextView deviceRssi; 


} 


11.24 蓝牙 BLE 服务 适配器 


在 前 面 11.2.2 的 内 容 中 用 到 了 蓝牙 BLE 服务 适配器 功能 ， 通 过 适配器 列表 显示 了 当前 扫描 到 的 蓝 


F BLE 服务 。 蓝 牙 BLE 服务 适配器 的 布局 文件 是 listitem_service.xml， 具 体 实现 代码 如 下 所 示 。 
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<?xml version="1.0" encoding="utf-8"?> 

<RelativeLayout 
xmins:android="http://schemas.android.com/apk/res/android" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:paddingTop-"4dp" 
android:paddingBottom="4dp" 
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android:paddingRight="10dp" 
android:paddingLeft="10dp"> 


<Button 
android:id="@+id/demo" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout alignParentRight-"true" 
android:layout centerVertical-"true" 
android:text="@string/action_demo" 
android:clickable="false" 
android:focusable="false" /> 

<TextView 
android:id="@+id/name" 
android:layout_width="match_parent" 
android:layout height="wrap content" 
android:layout_toLeftOf="@id/modes" 
android:textAppearance="?android:textAppearanceMedium" /> 

<TextView 
android:id="@+id/uuid" 
android:layout_width="match_parent" 
android:layout height="wrap content" 
android:layout_toLeftOf="@id/modes" 
android:layout_below="@+id/name" /> 


</RelativeLayout> 
对 应 的 程序 文件 是 BleServicesAdapterjava， 具 体 实现 代码 如 下 所 示 。 
public class BleServicesAdapter extends BaseExpandableListAdapter { 


private final static String TAG = BleServicesAdapter.class.getSimpleName(); 


public interface OnServiceltemClickListener { 
public void onDemoClick(BluetoothGattService service); 


public void onServiceEnabled(BluetoothGattService service, 
boolean enabled); 


public void onServiceUpdated(BluetoothGattService service); 
} 


private static final String MODE_READ = "R"; 
private static final String MODE_NOTIFY = "N"; 
private static final String MODE_WRITE = "W"; 


private final ArrayList<BluetoothGattService> services; 


private final HashMap<BluetoothGattService, ArrayList<BluetoothGattCharacteristic>> characteristics; 


private final Layoutinflater inflater; 


private BluetoothGattService heartRateService; 
private BluetoothGattCharacteristic heartRateCharacteristic; 
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private OnServiceltemClickListener serviceListener; 


public BleServicesAdapter(Context context, 
List<BluetoothGattService> gattServices) ( 
inflater = Layoutlnflater.from(context); 


services = new ArrayList<BluetoothGattService>(gattServices.size()); 
characteristics = new HashMap<BluetoothGattService, ArrayList<BluetoothGattCharacteristic>>( 
gattServices.size()); 
for (BluetoothGattService gattService : gattServices) ( 
final List<BluetoothGattCharacteristic> gattCharacteristics = gattService 
.getCharacteristics(); 
characteristics.put(gattService, 
new ArrayList<BluetoothGattCharacteristic>( 
gattCharacteristics)); 
services.add(gattService); 


if (gattService.getUuid().equals( 
UUID.fromString(BleHeartRateSensor.getServiceUUIDString()))) { 
heartRateService = gattService; 
heartRateCharacteristic = gattCharacteristics.get(0); 


} 


public void setServiceListener(OnServiceltemClickListener listener) { 
this.serviceListener = listener; 


} 


@Override 
public int getGroupCount() { 
return services.size(); 


} 


@Override 
public int getChildrenCount(int groupPosition) { 

return characteristics. get(getGroup(groupPosition)).size(); 
} 


@Override 
public BluetoothGattService getGroup(int groupPosition) { 
return services.get(groupPosition); 


} 


@Override 
public BluetoothGattCharacteristic getChild(int groupPosition, 
int childPosition) { 
Log.d(TAG, "group:" + groupPosition + " child:" + childPosition); 
Log.d(TAG, 
"uuid:" 
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+ characteristics.get(getGroup(groupPosition)) 
.get(childPosition).getUuid()); 
return characteristics.get(getGroup(groupPosition)).get(childPosition); 
} 


public BluetoothGattService getHeartRateService() { 
retum heartRateService; 
} 


public BluetoothGattCharacteristic getHeartRateCharacteristic() { 
return heartRateCharacteristic; 
} 


@Override 
public long getGroupld(int groupPosition) { 
return groupPosition; 


} 


@Override 

public long getChildld(int groupPosition, int childPosition) { 
return groupPosition * 100 + childPosition; 

} 


@Override 
public boolean hasStablelds() { 
return true; 


} 


@Override 
public View getGroupView(int groupPosition, boolean isExpanded, 
View convertView, ViewGroup parent) { 
final GroupViewHolder holder; 
if (convertView == null) { 
holder = new GroupViewHolder(); 


convertView = inflater.inflate(R.layout.listitem service, parent, 
false); 

holder.name = (TextView) convertView.findViewByld(R.id.name); 

holder.uuid = (TextView) convertView.findViewByld(R.id.uuid); 

holder.demo = convertView.findViewByld(R.id.demo); 


holder.demo.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
if (serviceListener == null) 
return; 


final BluetoothGattService service = (BluetoothGattService) holder.demo 


-getTag(); 
serviceListener.onDemoClick(service); 


» 
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} 


convertView.setTag(holder); 
) else { 

holder = (GroupViewHolder) convertView.getTag(); 
} 


final BluetoothGattService item = getGroup(groupPosition); 


final String uuid = item.getUuid().toString(); 
final BleSensor<?> sensor = BleSensors.getSensor(uuid); 
final BlelnfoService infoService = BlelnfoServices.getService(uuid); 


final String serviceName; 


if (sensor != null) 

serviceName = sensor.getName(); 
else if (infoService != null) 

serviceName = infoService.getName(); 
else 

serviceName = "Unknown"; 


holder.name.setText(serviceName); 

holder.uuid.setText(uuid); 

if (isDemoable(sensor)) ( 
holder.demo.setTag(item); 
holder.demo.setVisibility(View.VISIBLE); 

) else { 
holder.demo.setVisibility(View.GONE); 

} 


return convertView; 


@Override 
public View getChildView(int groupPosition, int childPosition, 


boolean isLastChild, View convertView, ViewGroup parent) { 
final ChildViewHolder holder; 
if (convertView == null) { 

holder = new ChildViewHolder(); 


convertView = inflater.inflate(R.layout.listitem characteristic, 
parent, false); 
holder.name = (TextView) convertView.findViewByld(R.id.name); 
holder.uuid = (TextView) convertView.findViewByld(R.id.uuid); 
holder.modes = (TextView) convertView.findViewByld(R.id.modes); 
holder.seek = (SeekBar) convertView.findViewByld(R.id.seek); 
holder.seek 
.setOnSeekBarChangeListener(new SeekBar.OnSeekBarChangeListener() ( 
@Override 
public void onProgressChanged(SeekBar seekBar, 
int progress, boolean fromUser) { 
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if (serviceListener == null || !fromUser) 
return; 


final BleSensor<?> sensor = BleSensors 
.getSensor(holder.service.getUuid() 
-toString()); 
if (sensor == null) 
return; 


) 


@Override 
public void onStartTrackingTouch(SeekBar seekBar) { 
} 


@Override 
public void onStopTrackingTouch(SeekBar seekBar) { 
} 

» 


convertView.setTag(holder); 
) else { 

holder = (ChildViewHolder) convertView.getTag(); 
) 


final BluetoothGattCharacteristic item = getChild(groupPosition, 
childPosition); 


final String uuid = item.getUuid().toString(); 
final String name; 
final String modes = getModeString(item.getProperties()); 


holder.service = item.getService(); 


final String serviceUUID = item.getService().getUuid().toString(); 

final BleSensor<?> sensor = BleSensors.getSensor(serviceUUID); 

final BlelnfoService infoService = BleInfoServices 
.getService(serviceUUID); 


if (sensor ! null) ( 
name = sensor.getCharacteristicName(uuid); 


if (sensor.isConfigUUID(uuid)) { 


) else { 
holder.uuid.setVisibility(View.VISIBLE); 
holder.seek.setVisibility(View.GONE); 
} 
} else if (infoService != null) { 
name = infoService.getCharacteristicName(uuid); 


317 


E: Android 外 设 开发 实战 


holder.uuid.setVisibility(View.VISIBLE); 

holder.seek.setVisibility(View.GONE); 
) else { 

name = "Unknown"; 


holder.uuid.setVisibility(View.VISIBLE); 
holder.seek.setVisibility(View.GONE); 
} 


holder.name.setText(name); 
holder.uuid.setText(uuid); 
holder.modes.setText(modes); 


return convertView; 


} 


@Override 
public boolean isChildSelectable(int groupPosition, int childPosition) { 
return true; 


} 


private static boolean isDemoable(BleSensor<?> sensor) { 
if (sensor instanceof BleHeartRateSensor) 
return true; 
return false; 


} 


private static String getModeString(int prop) { 

final StringBuilder modeBuilder = new StringBuilder(); 

if ((prop & BluetoothGattCharacteristic. PROPERTY READ) > 0) { 
modeBuilder.append(MODE READ); 

} 

if ((prop & BluetoothGattCharacteristic PROPERTY NOTIFY) > 0) { 
if (modeBuilder.length() > 0) 

modeBuilder.append("/"); 

modeBuilder.append(MODE NOTIFY); 


} 
if ((prop & BluetoothGattCharacteristic PROPERTY WRITE) > 0) { 
if (modeBuilder.length() > 0) 
modeBuilder.append("/"); 
modeBuilder.append(MODE WRITE); 
) 


return modeBuilder.toString(); 
) 


private static class GroupViewHolder ( 
public TextView name; 
public TextView uuid; 
public View demo; 
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private static class ChildViewHolder { 
public BluetoothGattService service; 


public TextView name; 
public TextView uuid; 
public TextView modes; 
public SeekBar seek; 


} 
11.2.5 ”传感器 测试 心率 


本 实例 的 核心 功能 是 通过 传感器 测试 心率 ， 此 功能 的 核心 文件 是 BleHeartRateSensorjava， 功 能 是 
获取 当前 蓝牙 设备 的 信息 参数 ,例如 服务 UUID、 数 据 UUD 等 ， 并 输出 获得 心率 的 信息 ， 输 出 的 信息 
有 UINT16 和 UINTS 两 种 格式 。 

public class BleHeartRateSensor extends BleSensor«float[ ]> { 

private final static String TAG = BleHeartRateSensor.class.getSimpleName(); 
private static final String UUID SENSOR BODY LOCATION = "00002a38-0000-1000-8000-00805f9b34fb". 
private static final int SENSOR BODY LOCATION OTHER = 0; 
private static final int SENSOR_BODY_LOCATION_CHEST = 1; 
private static final int SENSOR_BODY_LOCATION_WRIST = 2; 
private static final int SENSOR BODY LOCATION FINGER = 3; 
private static final int SENSOR BODY LOCATION HAND - 4; 
private static final int SENSOR BODY LOCATION EAR = 5; 
private static final int SENSOR BODY LOCATION FOOT = 6; 
private int location 7 -1; 
BleHeartRateSensor() ( 
super(); 


) 

@Override 

public String getName() { 
return "Heart rate"; 


} 
@Override 


public String getServiceUUID() { 
return "00001 80d-0000-1000-8000-00805f9b34fb"; 
} 


public static String getServiceUUIDString() { 
return "0000180d-0000-1000-8000-00805f9b34fb"; 
} 


@Override 
public String getDataUUID() { 

retum "00002a37-0000-1000-8000-00805f9b34fb"; 
} 


public static String getDataUUIDString() { 
return "00002a37-0000-1000-8000-00805f9b34fb"; 
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} 


@Override 
public String getConfigUUID() ( 
return "00002902-0000-1000-8000-00805f9b34fb"; 


) 


@Override 
public String getCharacteristicName(String иша) { 
if (UUID SENSOR BODY LOCATION.equals(uuid)) 
return getName() + " Sensor body location"; 
return super.getCharacteristicName(uuid); 


} 


@Override 

public boolean onCharacteristicRead(BluetoothGattCharacteristic с) { 
super.onCharacteristicRead(c); 
Log.d(TAG, "onCharacteristicsReas"); 


if ( !c.getUuid().toString().equals(UUID SENSOR BODY LOCATION) ) 
return false; 
location 7 c.getProperties(); 
Log.d(TAG, "Sensor body location: " * location); 
return true; 
} 
@Override 
public String getDataString() { 
final float[ ] data = getData(); 
return "heart rate=" + data[0] + ^ninterval-" + data[1]; 


} 


@Override 
public float[ ] parse(BluetoothGattCharacteristic c) { 


double heartRate = extractHeartRate(c); 

double contact = extractContact(c); 

double energy = extractEnergyExpended(c); 
Integer[ ] interval = extractBeatToBeatinterval(c); 


float[ ] result = null; 
if (interval != null) { 
result = new float[interval.length + 1]; 


) else { 
result = new float[2]; 
result[1] = -1.0f; 

) 


result[0] = (float) heartRate; 


if (interval != null) ( 
for (int i = 0; i < interval.length; i++) { 
result[i+1] = interval[i].floatValue(); 
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} 


return result; 


} 


private static double extractHeartRate( 
BluetoothGattCharacteristic characteristic) { 


int flag = characteristic.getProperties(); 

Log.d(TAG, "Heart rate flag: " + flag); 

int format = -1; 

/心率 数字 格式 

if ((flag & 0x01) != 0) ( 
format = BluetoothGattCharacteristic. FORMAT_UINT16; 
Log.d(TAG, "Heart rate format UINT16."); 

) else { 
format = BluetoothGattCharacteristic.FORMAT_UINT8; 
Log.d(TAG, "Heart rate format UINT8."); 

} 

final int heartRate = characteristic.getintValue(format, 1); 

Log.d(TAG, String.format("Received heart rate: %d", heartRate)); 

retum heartRate; 

} 


private static double extractContact( 
BluetoothGattCharacteristic characteristic) { 


int flag = characteristic.getProperties(); 
int format = -1; 
/传感器 连接 状态 
if (flag & 0x02) != 0) { 
Log.d(TAG, "Heart rate sensor contact info exists"); 
if ((flag & 0x04) != 0) { 
Log.d(TAG, "Heart rate sensor contact is ON"); 
} else { 
Log.d(TAG, "Heart rate sensor contact is OFF"); 
} 
) elsef 
Log.d(TAG, "Heart rate sensor contact info doesn't exists"); 
} 
//final int heartRate = characteristic.getlntValue(format, 1); 
//Log.d(TAG, String.format("Received heart rate: %d", heartRate)); 
return 0.0d; 
} 


private static double extractEnergyExpended( 
BluetoothGattCharacteristic characteristic) { 


int flag = characteristic.getProperties(); 
int format = -1; 
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П 计算 活力 状态 
if (flag & 0x08) != 0) { 
Log.d(TAG, "Heart rate energy calculation exists."); 
) else { 
Log.d(TAG, "Heart rate energy calculation doesn't exists."); 
) 
IIfinal int heartRate = characteristic.getlntValue(format, 1); 
IILog.d(TAG, String.format("Received heart rate: %d", heartRate)); 
return 0.0d; 
) 


private static Integer[ ] extractBeatToBeatlnterval( 
BluetoothGattCharacteristic characteristic) { 


int flag = characteristic.getlntValue(BluetoothGattCharacteristic.FORMAT_UINT8, 0); 
int format = -1; 

int energy = -1; 

int offset = 1; // This depends on hear rate value format and if there is energy data 
int rr_count = 0; 


if ((flag & 0x01) != 0) { 
format = BluetoothGattCharacteristic FORMAT UINT 16; 
Log.d(TAG, "Heart rate format UINT16."); 
offset = 3; 

) else ( 
format = BluetoothGattCharacteristic.FORMAT_UINT8; 
Log.d(TAG, "Heart rate format UINT8."); 


offset = 2; 
) 
if ((flag & 0x08) ! 0) { 
// 目 前 卡路里 
energy = characteristic.getlntValue(BluetoothGattCharacteristic.FORMAT_UINT16, offset); 
offset += 2; 
Log.d(TAG, "Received energy: { )"+ energy); 
} 
if ((flag & 0x16) != 0)( 


II stuff 值 
Log.d(TAG, "RR stuff found at offset: "+ offset); 
Log.d(TAG, "RR length: "+ (characteristic.getValue()).length); 
rr_count = ((characteristic.getValue()).length - offset) / 2; 
Log.d(TAG, "RR length: "+ (characteristic.getValue()).length); 
Log.d(TAG, "rr count: "+ rr count); 
if (rr count > 0) { 
Integer[ ] mRr. values = new Integer[rr count]; 
for (inti = 0; i < rr count; i++) ( 
mRr_values[i] = characteristic.getintValue( 
BluetoothGattCharacteristic. FORMAT _UINT16, offset); 
offset += 2; 
Log.d(TAG, "Received RR: " + mRr_valuesfi]); 
} 


return mRr_values; 
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} 
} 
Log.d(TAG, "No RR data on this update: "); 
return null; 


} 
11.26 ”图 形 化 显示 心率 值 


当 读 取 到 传感器 的 心率 值 后 ， 会 通过 BLE 蓝牙 将 数据 传输 到 检测 设备 中 ， 在 Android 系统 中 通过 
图 形 化 界面 方式 显示 检测 到 的 心率 值 。 上 述 功能 的 UI 布局 文件 是 demo_opengl.xml， 具 体 实 现代 码 如 
下 所 示 。 

<?xml version="1.0" encoding="utf-8"?> 

<FrameLayout 
xmins:android="http://schemas.android.com/apk/res/android" 
android:layout width="match_ parent" 
android:layout height-"match parent"» 


«com.sample.hrv.demo.DemoGLSurfaceView 
android:id-"(Q*id/gl" 
android:layout width-"match parent" 
android:layout height-"match parent" /> 
<TextView 
android:id="@+id/text" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:layout_margin="10dp" 
android:textAppearance="?android:textAppearanceMedium"/> 
</FrameLayout> 
对 应 的 程序 文件 是 DemoHeartRateSensorActivityjava, 功能 是 根据 获取 的 心率 值 构建 一 个 图 形 化 的 
心率 图 ， 有 具体 实现 代码 如 下 所 示 。 
public class DemoHeartRateSensorActivity extends DemoSensorActivity { 
private final static String TAG = DemoHeartRateSensorActivity.class 
.getSimpleName(); 


private TextView viewText; 
private PolygonRenderer renderer; 


private GLSurfaceView view; 

@Override 

public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.demo opengl); 
view = (GLSurfaceView) findViewByld(R.id.gl); 


getActionBar().setTitle(R.string.tile demo heartrate); 
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} 


viewText = (TextView) findViewByld(R.id.text); 


renderer = new PolygonRenderer(this); 

view.setRenderer(renderer); 
/lview.setRenderMode(GLSurfaceView.RENDERMODE CONTINUOUSLY); 
II Render when hear rate data is updated 
view.setRenderMode(GLSurfaceView.RENDERMODE WHEN DIRTY); 


@Override 
public void onDataRecieved(BleSensor<?> sensor, String text) { 


} 


if (sensor instanceof BleHeartRateSensor) { 
final BleHeartRateSensor heartSensor = (BleHeartRateSensor) sensor; 
float[ ] values = heartSensor.getData(); 
renderer.setinterval(values); 
view.requestRender(); 


viewText.setText(text); 


public abstract class AbstractRenderer implements GLSurfaceView.Renderer { 


public int[ ] getConfigSpec() { 
int[ ] configSpec = ( EGL10.EGL_DEPTH_SIZE, 0, EGL10.EGL NONE }; 
return configSpec; 


} 


public void onSurfaceCreated(GL10 gl, EGLConfig eglConfig) ( 
gl.glDisable(GL10.GL_DITHER); 
gl.glHin(GL10.GL PERSPECTIVE CORRECTION HINT, GL10.GL FASTEST); 
gl.glClearColor(.5f, .5f, .5f, 1); 
gl.glShadeModel(GL10.GL SMOOTH); 
gl.glEnable(GL10.GL DEPTH TEST); 

} 


public void onSurfaceChanged(GL10 gl, int w, int h) { 
gl.glViewport(0, 0, w, h); 
float ratio = (float) w / h; 
gl.glMatrixMode(GL10.GL_PROJECTION); 
gl.glLoadidentity(); 
gl.glFrustumf(-ratio, ratio, -1, 1, 3, 7); 

) 


public void onDrawFrame(GL10 gl) { 
gl.glDisable(GL10.GL_DITHER); 
gl.glClear(GL10.GL COLOR BUFFER ВІТ | GL10.GL DEPTH BUFFER ВІТ); 
gl.glMatrixMode(GL10.GL_MODELVIEW); 
gl.glLoadidentity(); 
GLU.gluLookAt(gl, 0, 0, -5, Of, Of, Of, Of, 1.0f, 0.09); 
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gl.glEnableClientState(GL10.GL_VERTEX_ARRAY): 
draw(gl); 
H 


protected abstract void draw(GL10 gl); 
} 


public class PolygonRenderer extends AbstractRenderer { 
private final String TAG = PolygonRenderer.class 
.getSimpleName(); 


11 Number of points or vertices we want to use 
private final static int VERTS = 4; 


1/ А raw native buffer to hold the point coordinates 
private FloatBuffer mFVertexBuffer; 


II А raw native buffer to hold indices 
II allowing a reuse of points. 
private ShortBuffer mIndexBuffer; 


private int numOflndecies = 0; 
private long prevtime = SystemClock.uptimeMillis(); 
private int sides = 32; 


private float[ ] interval = { 0, 0, 0 }; 
private float previousInterval = 0; 


public void setInterval(float[ ] interval) { 

if (this.interval[1] >= 0 && interval[1] > 0) ( 
this.previouslnterval = this.interval[1]; 

) 
this.interval[0] = interval[0]; // heart rate 
this.interval[1] = interval[1]; // beat to beat interval 
this.interval[2] = 0; // empty 

} 


public PolygonRenderer(Context context) { 
prepareBuffers(sides, interval[1]); 
} 


private void prepareBuffers(int sides, float radius) { 
Log.d(TAG,"radius: "+radius +" previous: "+previousinterval); 
II Is it a valid value? 
if (radius < 0) { 
radius = previousInterval; 


} 
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} 


II Double check if the previous value was valid 
if (radius « 0) ( 
radius = 700; 
) 
Log.d(TAG,"final radius: "+radius); 


radius = ( ( radius / 1000 ) - 0.7f ) * 2; 


RegularPolygon t = new RegularPolygon(0, 0, 0, radius, sides); 
this.mFVertexBuffer = t.getVertexBuffer(); 

this.mIndexBuffer = t.getIndexBuffer(); 

this.numOflndecies = t.getNumberOflndecies(); 
this.mFVertexBuffer.position(0); 

this.mIndexBuffer.position(0); 


II overriden method 
protected void draw(GL10 gl) { 


} 
} 


long curtime = SystemClock.uptimeMillis(); 

this.prepareBuffers(sides, interval[1]); 

gl.glColor4f(96/255.0f, 246/255 .0f, 255/255.0f, 1.0f); 

gl.glVertexPointer(3, GL10.GL FLOAT, 0, mFVertexBuffer); 

gl.gIDrawElements(GL10.GL TRIANGLES, this.numOflndecies, 
GL10.GL UNSIGNED SHORT, mindexBuffer); 


private static class RegularPolygon ( 
private static final String TAG = RegularPolygon.class 


.getSimpleName(); 


private float cx, cy, cz, r; 

private int sides; 

private float[ ] xarray = null; 

private float[] yarray = null; 

public RegularPolygon(float incx, float incy, float incz, // (x,y,z) 


} 


float inr, // radius 
int insides) // number of sides 


cx = incx; 

су = incy; 

cz = incz; 

r-inr; 

sides - insides; 

xarray = new float[sides]; 
yarray = new float[sides]; 
calcArrays(); 


private void calcArrays() ( 
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float[ ] xmarray - this.getXMultiplierArray(); 
float[ ] ymarray = this.getYMultiplierArray(); 
II calc xarray 


II center 


} 
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for (int i = 0; i < sides; i++) { 
float curm = xmarray[i]; 
float xcoord = cx + r * curm; 
xarray[i] = xcoord; 

} 

IIthis.printArray(xarray, "xarray"); 

II calc yarray 

for (int i = 0; i < sides; i++) { 
float curm = ymarray|i]; 
float ycoord = cy + r * curm; 
yarray[i] = ycoord; 

} 

/ithis.printArray(yarray, "yarray"); 


public FloatBuffer getVertexBuffer() { 


} 


int vertices = sides + 1; 

int coordinates = 3; 

int floatsize = 4; 

int spacePerVertex = coordinates * floatsize; 


ByteBuffer vbb = ByteBuffer.allocateDirect(spacePerVertex 
* vertices); 

vbb.order(ByteOrder.nativeOrder()); 

FloatBuffer mFVertexBuffer = vbb.asFloatBuffer(); 


// Put the first coordinate (x,y,z:0,0,0) 
mFVertexBuffer.put(0.0f); // x 
mFVertexBuffer.put(0.0f); // y 
mFVertexBuffer.put(0.0f); // z 


int totalPuts = 3; 

for (int i = 0; i < sides; i++) { 
mFVertexBuffer.put(xarray[i]); // x 
mFVertexBuffer.put(yarray[i]); // y 
mFVertexBuffer.put(0.0f); // z 
totalPuts += 3; 

) 

//Log.d(TAG, "total puts: " + Integer.toString(totalPuts)); 

return mFVertexBuffer; 


public ShortBuffer getIndexBuffer() { 


Short[ ] iarray = new short[sides * 3]; 
ByteBuffer ibb = ByteBuffer.allocateDirect(sides * 3 * 2); 
ibb.order(ByteOrder.nativeOrder()); 
ShortBuffer mIndexBuffer = ibb.asShortBuffer(); 
for (int i = 0; i < sides; i++) { 
short index1 = 0; 
Short index2 = (short) (i + 1); 
Short index3 - (short) (i * 2); 
if (index3 == sides + 1)( 
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index3 = 1; 
} 
mindexBuffer.put(index1); 
mindexBuffer.put(index2); 
mindexBuffer.put(index3); 


iarray[i * 3 + 0] = indext; 
iarray[i * 3 + 1] = index2; 
iarray[i * 3 + 2] = index3; 
} 
IIthis.printShortArray(iarray, "index array"); 
return mindexBuffer; 
} 
private float[ ] getXMultiplierArray() { 
float[ ] angleArray = getAngleArrays(); 
float[ ] xmultiplierArray = new float[sides]; 
for (int i = 0; i < angleArray.length; i++) { 
float curAngle = angleArray[i]; 
float sinvalue = (float) Math.cos(Math.toRadians(curAngle)); 
float absSinValue = Math.abs(sinvalue); 
if (isXPositiveQuadrant(curAngle)) { 
sinvalue = absSinValue; 
) else { 
sinvalue = -absSinValue; 
) 
xmultiplierArray[i] = this.getApproxValue(sinvalue); 
) 
/ithis.printArray(xmultiplierArray, "xmultiplierArray"); 
return xmultiplierArray; 
} 
private float[ ] getYMultiplierArray() { 
float[ ] angleArray = getAngleArrays(); 
float[ ] ymultiplierArray = new float[sides]; 
for (int i = 0; i « angleArray.length; i++) ( 
float curAngle = angleArrayf[i]; 
float sinvalue = (float) Math.sin(Math.toRadians(curAngle)); 
float absSinValue = Math.abs(sinvalue); 
if (isYPositiveQuadrant(curAngle)) ( 
sinvalue = absSinValue; 
) else { 
sinvalue = -absSinValue; 
} 
ymultiplierArray[i] = this.getApproxValue(sinvalue); 
} 
IIthis.printArray(ymultiplierArray, "ymultiplierArray"); 
return ymultiplierArray; 
) 
private boolean isXPositiveQuadrant(float angle) { 
if ((0 <= angle) && (angle <= 90)) ( 
return true; 


} 
if ((angle < 0) && (angle >= -90)) { 
return true; 
} 
return false; 
} 
private boolean isYPositiveQuadrant(float angle) { 
if ((0 <= angle) && (angle <= 90)) { 
return true; 
} 
if ((angle < 180) && (angle >= 90)) { 
return true; 
} 
retum false; 
} 
private float[ ] getAngleArrays() { 
float[ ] angleArray = new float[sides]; 
float commonAngle = 360.0f / sides; 
float halfAngle = commonAngle / 2.0f; 
float firstAngle = 360.0f - (90 + halfAngle); 
angleArray[0] = firstAngle; 
float curAngle = firstAngle; 
for (int i = 1; i < sides; i++) { 
float newAngle = curAngle - commonAngle; 
angleArray[i] = newAngle; 
curAngle = newAngle; 
) 
//printArray(angleArray, "angleArray"); 
return angleArray; 


} 
private float getApproxValue(float f) { 
if (Math.abs(f) < 0.001) { 
return 0; 
} 
return f; 
) 


public int getNumberOfindecies() ( 
return sides * 3; 
} 
private void printArray(float array[ ], String tag) { 
StringBuilder sb = new StringBuilder(tag); 
for (int i = 0; i < array.length; i++) { 
sb.append(";").append(arrayf[i]); 
H 
Log.d(TAG, sb.toString()); 
h 
private void printShortArray(short array[ ], String tag) { 
StringBuilder sb = new StringBuilder(tag); 
for (int i = 0; i < array.length; i++) ( 
sb.append(";").append(array[i]); 
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} 
Log.d(TAG, sb.toString()); 


} 
i 
执行 效果 如 图 11-3 所 示 。 


Heart rate variability Demo 


图 11-3 图 形 化 心率 界面 


skies 湿度 测试 仪 


和 测量 重量 、 温 度 一 样 ， 选 择 湿度 传感器 首先 要 确定 测量 范围 。 除 了 气象 、 科 研 部 门 外 ， 高 温 、 
湿度 测控 一 般 不 需要 全 湿 程 (0~100%RH) 测量 。 在 当今 的 信息 时 代 ， 传 感 器 技术 与 计算 机 技术 、 自 
动 控制 技术 紧密 结合 着 。 测 量 的 目的 在 于 控制 ， 测 量 范围 与 控制 范围 合 称 使 用 范围 。 当 然 ， 对 不 需要 
搞 测 控 系 统 的 应 用 者 来 说 ， 直 接 选 择 通用 型 湿度 仪 就 可 以 了 。 本 章 将 详细 讲解 Android 设备 中 湿度 传 
感 器 的 基本 知识 ， 为 读者 学 习 本 书后 面 的 知识 打下 基础 。 


12.1 实现 主 界 面 


ШМ 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 12 章 \ 实 现 主 界面 .avi 
本 章 将 通过 一 个 演示 实例 来 详细 讲解 使 用 湿度 传感器 开发 一 个 湿度 测试 仪 的 方法 ， 本 实例 可 以 在 
Android 设备 上 运行 , 测试 当前 天 气 环境 下 的 湿度 。 在 本 节 的 内 容 中 , 将 首先 讲解 实现 主 界面 的 具体 过 程 。 
实例 | 功能 E I | 源码 路 径 
实例 12-1 获取 远程 湿度 传感器 的 数据 光盘 :daima\l12\humiditytrackerEX 


12.1.1 ”实现 主 界面 布局 文件 


编写 主 界面 布局 文件 main.xml， 功 能 是 通过 按钮 控件 在 主 界 面 中 分 别 显 示 6 监测 点 的 值 ， 具 体 实 
现代 码 如 下 所 示 。 

«LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="fill_ parent" 
android:layout_height="fill_ parent" 
android:padding="10dp" 
> 

<Button 
android:id="@+id/reading" 
android:text="@string/takereading" 
android:layout_width="fill_ parent" 
android:layout_height="wrap_content" 
android:layout_weight="0" 
style="@style/BigFont" 
android:paddingTop-"15dp" 
android:paddingBottom="15dp" 
> 

<TableLayout 
android:layout_width="fill_parent" 
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android:layout height-"fill parent" 
android:layout weight-"1" 
android:stretchColumns="0, 1" 
> 
<TableRow> 
<Button 
android:id="@+id/stored1" 
android:textColor="@color/stored1" 
style="@style/StoredButton" 
> 
<Button 
android:id="@+id/stored2" 
android:textColor="@color/stored2" 
style="@style/StoredButton" 
> 
</TableRow> 
<TableRow> 
<Button 
android:id="@+id/stored3" 
android:textColor="@color/stored3" 
style="@style/StoredButton" 
> 
<Button 
android:id="@+id/stored4" 
android:textColor="@color/stored4" 
style="@style/StoredButton" 
[> 
</TableRow> 
<TableRow> 
<Button 
android:id="@+id/stored5" 
android:textColor="@color/stored5" 
style="@style/StoredButton" 
> 
<Button 
android:id="@+id/stored6" 
android:textColor="@color/stored6" 
style="@style/StoredButton" 
> 
</TableRow> 
</TableLayout> 


<TextView 
android:text="@string/copyright" 
android:textSize="12dp" 
android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
> 


</LinearLayout> 


12.1.2 + Activity 的 实现 文件 


+ Activity 的 实现 文件 是 HumidityActivity.java, 功能 是 监听 用 


执行 对 应 的 处 理事 件 函数 。 文 件 HumidityActivity.java 的 具体 实 
public class HumidityActivity extends Activity { 
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户 触摸 单 击 了 屏幕 中 的 哪 一 个 按钮 ， 
观 代 码 如 下 所 示 。 


public static final String EXTRA_HUMIDITY = "com.leafdigital.humidity.Humidity"; 

public static final String EXTRA TEMP = “com.leafdigital.humidity. Temp"; 

public static final String EXTRA_HUMIDITY_ERROR = "com.leafdigital.humidity.HumidityError"; 
public static final String EXTRA TEMP ERROR = "com.leafdigital.humidity.TempE ror"; 

public static final String EXTRA SAVEBANK = "com.leafdigital.humidity.SaveBank"; 


public final static String PREFS. BANK NAME = "bankName"; 


/** Called when the activity is first created. */ 
@Override 
public void onCreate(Bundle savedinstanceState) 
{ 
super.onCreate(savedinstanceState); 
setContentView(R.layout.main); 


findViewByld(R.id.reading).setOnClickListener(new OnClickListener() 


{ 
@Override 
public void onClick(View v) 
{ 
startActivityForResult( 
new Intent(HumidityActivity.this, TakeReadingActivity.class), 0); 
} 
}); 


int[ ] ids = ( R.id.stored1, R.id.stored2, R.id.stored3, 
R.id.stored4, R.id.stored5, R.id.stored6 }; 
for(int i=0; i<6; i++) 
{ 
final int storeNum = i; 
Button storedButton = (Button)findViewByld(ids[i]); 


storedButton.setOnClickListener(new View.OnClickListener() 


{ 
@Override 
public void onClick(View v) 


{ 


Intent intent = new Intent(HumidityActivity.this, ShowRecordsActivity.class); 


intent.putExtra(EXTRA_SAVEBANK, storeNum); 


startActivity(intent); 
} 
» 
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@Override 
protected void onResume() 
{ 
іп ] ids = ( R.id.stored1, R.id.stored2, R.id.stored3, 
R.id.stored4, R.id.stored5, R.id.stored6 y; 
for(int i=0; i<6; i++) 
{ 
Button storedButton = (Button)findViewByld(idsfi]); 
storedButton.setText(HumidityActivity.getBankName(this, i)); 
} 


super.onResume(); 
} 


@Override 
protected void onActivityResult(int requestCode, int resultCode, Intent data) 
{ 
11 \gnore anything but okay 
if(resultCode |= RESULT OK) 


{ 
return; 
) 
if(data != null && data.getIntExtra(EXTRA_SAVEBANK, -1) != -1) 
( 
save( 


data.getlntExtra(EXTRA SAVEBANK, -1), 
System.currentTimeMillis(), 
data.getDoubleExtra(EXTRA TEMP, 0.0), 
data.getFloatExtra(EXTRA TEMP ERROR, 0.0f), 
data.getDoubleExtra(EXTRA HUMIDITY, 0.0), 
data.getFloatExtra(EXTRA HUMIDITY ERROR, 0.0f)); 


Intent intent = new Intent(HumidityActivity.this, ShowRecordsActivity.class); 
intent.putExtra(EXTRA_SAVEBANK, data.getIntExtra(EXTRA_SAVEBANK, -1)); 
startActivity(intent); 

} 
} 


private void save(int bank, long time, double temp, float tempError, 
double humidity, float humidityError) 

{ 
SQLiteDatabase db = new RecordsOpenHelper(this).getWritableDatabase(); 
ContentValues values = new ContentValues(); 
values.put("bank", bank); 
values.put("javatime", time); 
values.put("temperature", temp); 
values.put("humidity", humidity); 
values.put("temperature error", tempError); 
values.put("humidity error", humidityError); 
db.insert("readings", null, values); 
db.close(); 
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} 


public static String getBankName(Activity activity, int bank) 
{ 
return activity.getSharedPreferences("com.leafdigital.humidity", MODE_PRIVATE).getString( 
PREFS_BANK_NAME + bank, "" + (bank+1)); 
} 
} 
系统 主 界面 的 执行 效果 如 图 12-1 所 示 。 


Humidity tracker 


ro N No) 
Take new reading 


_ 
tav 


图 12-1 系统 主 界面 的 执行 效果 


12.2 设置 具体 值 


知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 12 章 \ 设 置 具体 值 .avi 
当 单 击 Take new reading 按钮 后 会 弹出 设置 具体 值 界面 ， 此 界面 的 布局 文件 是 takereading.xml， 在 
界面 中 可 以 设置 温度 和 湿度 值 ， 具 体 实现 代码 如 下 所 示 。 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="fill_ parent" 
android:layout height-"fill parent" 
android:padding="10dp" 
> 


<TextView 
android:layout_width="fill_ parent" 
android:layout_height="wrap_content" 
android:text="@string/temp" 
style="@style/BigFont" 
> 


<LinearLayout 
android:orientation="horizontal" 
android:layout_width="fill_ parent" 
android:layout_height="wrap_content" 
> 


<EditText 
android:layout width-"wrap content" 
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android:layout_height="wrap_content" 
android:id="@+id/temp" 
android:inputType="numberDecimal" 
android:width="100dp" 

> 


<TextView 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:paddingLeft="5dp" 
android:text="@string/degreesc" 


style="@style/BigFont" 
> 


<TextView 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:paddingLeft="10dp" 
android:text="@string/plusminus" 


style="@style/BigFont" 
> 


<EditText 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:id="@+id/temperror" 


android:inputType="numberDecimal" 
android:width="60dp" 
> 


</LinearLayout> 


<TextView 
android:layout_width="fill_ parent" 
android:layout_height="wrap_content" 
android:text="@string/humidity" 
android:paddingTop="15dp" 


style="@style/BigFont" 
> 


<LinearLayout 
android:layout_width="fill_ parent" 
android:layout_height="wrap_content" 
android:orientation="horizontal" 

android:paddingBottom="30dp" 


> 
<EditText 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:id="@+id/humidity" 
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android:inputType="numberDecimal" 
android:width="100dp" 
> 


<TextView 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android: paddingLeft="5dp" 
android:text="@string/percent" 


style="@style/BigFont" 
> 


<TextView 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:paddingLeft="10dp" 
android:text="@string/plusminus" 


style="@style/BigFont" 
> 


<EditText 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:id="@+id/humidityerror" 
android:inputType="numberDecimal" 
android:width="60dp" 
> 


</LinearLayout> 


<Button 


android:layout_width="fill_ parent" 
android:layout height="wrap content" 
android:id="@+id/ok" 
android:text="@string/ok" 
android:enabled="false" 
style="@style/BigFont" 


> 
</LinearLayout> 
对 应 的 程序 文件 是 TakeReadingActivityjava， 功 能 是 获取 用 户 设置 的 温度 值 和 湿度 值 进 行 保存 , 具 
体 实现 代码 如 下 所 示 。 
public class TakeReadingActivity extends Activity 


{ 
private final static String DECIMAL REGEX = "[0-9]+(\\.[0-9]+)?"; 


private final static String PREFS_TEMP_ERROR = "tempError", 
PREFS HUMIDITY ERROR = "humidityError"; 


private Button ok; 
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private EditText tempEdit, humidityEdit, tempErrorEdit, humidityErrorEdit; 


p 
* Rounds a value for display. This rounds to two decimal places, but then 
* discards the decimal places if not used, so that it can display results 
* of the form 0.97, 0.9, and 0. 

* (param value Value 
* @retum String 
“fl 

private static String roundValue(float value) 

{ 

String s = String.format("%.2f", value); 
while(s.endsWith("0")) 
{ 


} 
if(s.endsWith(".")) 


{ 
} 


return s; 


s = s.substring(0, s.length() - 1); 


s = s.substring(0, s.length() - 1); 


} 


/** Called when the activity is first created. */ 
@Override 
public void onCreate(Bundle savedinstanceState) 
{ 
super.onCreate(savedinstanceState); 
setContentView(R.layout.takereading); 


ok = (Button)findViewByld(R.id.ok); 

tempEdit = (EditText)findViewByld(R.id.temp); 

tempErrorEdit = (EditText)findViewByld(R.id.temperror); 
humidityEdit = (EditText)find ViewByld(R.id.humidity); 
humidityErrorEdit = (EditText)find ViewByld(R..id.humidityerror); 


II Set default error values 

SharedPreferences prefs = getSharedPreferences("com.leafdigital.humidity" MODE PRIVATE); 
tempErrorEdit.setText(roundValue(prefs.getFloat(PREFS TEMP ERROR, 1.0f))); 
humidityErrorEdit.setText(roundValue(prefs.getFloat(PREFS HUMIDITY ERROR, 4.0f))); 


TextWatcher watcher = new TextWatcher() 
{ 
@Override 
public void afterTextChanged(Editable arg0) 
{ 
textChanged(); 
} 


@Override 
public void beforeTextChanged(CharSequence arg0, int arg1, int arg2, 
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int arg3) 
{ 
} 
@Override 
public void onTextChanged(CharSequence arg), int arg1, int arg2, int arg3) 
{ 
} 


hk 

tempEdit.addTextChangedListener(watcher); 
tempErrorEdit.addTextChangedListener(watcher); 
humidityEdit.add TextChangedListener(watcher); 
humidityErrorEdit.addTextChangedListener(watcher); 


ok.setOnClickListener(new OnClickListener() 
{ 
@Override 
public void onClick(View v) 
{ 
II User has entered a reading 
double temp = Double.parseDouble(tempEdit.getT ext().toString()); 
double humidity = Double.parseDouble(humidityEdit.getText().toString()); 


float tempError = Float.parseFloat(tempErrorEdit.getT ext().toString()); 
float humidityError = Float. parseFloat(humidityErrorEdit.getText().toString()); 


II Update preferences to track the error 


SharedPreferences prefs = getSharedPreferences("com.leafdigital.humidity" MODE_PRIVATE); 


if(prefs.getFloat(PREFS_TEMP_ERROR, 1.0f) != tempError 
|| prefs.getFloat(PREFS HUMIDITY ERROR, 1.0f != humidityError) 
{ 
SharedPreferences.Editor editor = prefs.edit(); 
editor.putFloat(PREFS TEMP ERROR, tempkError); 
editor.putFloat(PREFS HUMIDITY ERROR, humidityError); 
editor.commit(); 


Intent intent = new Intent(TakeReadingActivity.this, ShowReadingActivity.class); 


intent.putExtra(EXTRA TEMP, temp); 
intent.put&Extra(EXTRA TEMP ERROR, tempError); 
intent.putExtra(EXTRA HUMIDITY, humidity); 
intent.putExtra(EXTRA HUMIDITY ERROR, humidityError); 


startActivityForResult(intent, 0); 


ys 
} 


@Override 
protected void onActivityResult(int requestCode, int resultCode, Intent data) 
{ 
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11 Pass result data through, and finish 
if(resultCode == RESULT OK) 


{ 
setResult(resultCode, data); 
finish(); 
} 
} 
private void textChanged() 
{ 


String tempString = tempEdit.getText().toString(); 
String tempErrorString = tempErrorEdit.getText().toString(); 
String humidityString = humidityEdit.getText().toString(); 
String humidityErrorString = humidityErrorEdit.getText().toString(); 
ok.setEnabled( 
tempString.matches(DECIMAL REGEX) 
&& tempErrorString.matches(DECIMAL_REGEX) 
&& humidityString.matches(DECIMAL_REGEX) 
&& humidityErrorString.matches(DECIMAL REGEX) 
&& Double.parseDouble(tempString) <= 40.0 
&& Double.parseDouble(tempErrorString) <= 10.0 
&& Double.parseDouble(humidityString) <= 100.0 
&& Double.parseDouble(humidityString) >= 1.0 
&& Double.parseDouble(humidityErrorString) <= 10.0); 
} 
} 


系统 设置 界面 的 执行 效果 如 图 12-2 所 示 。 


Таке new reading 


图 122 系统 设置 界面 的 执行 效果 
123 ”显示 当前 的 值 


GH 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 12 章 \ 显 示 当前 的 值 .avi 


布局 文件 showreading.xml 的 功能 是 ， 通 过 文本 控件 显示 当前 的 温度 、 湿 


BE. жы KA 


FP 的 湿 空 气 由 


于 温度 下 降 , 使 所 含 的 水 蒸气 达到 饱和 状态 而 开始 凝结 时 的 温度 ) 和 水 密度 值 。 文件 showreading.xml 的 具 


体 实现 代码 如 下 所 示 。 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="fill_ parent" 


@ 
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android:layout height-"fill parent" 
android:padding="10dp" 
> 


<LinearLayout 
android:orientation="horizontal" 
style="@style/ShowTableRow" 

> 

<TextView 
android:text="@string/temp" 
style="@style/ShowTableRowLabel" 
> 

<TextView 
android:id="@+id/showTempL" 
style="@style/ShowTableRowValue" 
> 

<TextView 
style="@style/ShowTableRowTo" 
> 

<TextView 
android:id="@+id/showTempH" 
style="@style/ShowTableRowValue2" 
> 

<TextView 
android:text="@string/degreesc" 
style="@style/ShowTableRowUnit" 
> 

</LinearLayout> 


<LinearLayout 
android:orientation="horizontal" 
style="@style/ShowTableRow" 

> 

<TextView 
android:text="@string/humidity" 
style="@style/ShowTableRowLabel" 
> 

<TextView 
android:id="@+id/showHumidityL" 
style="@style/ShowTableRowValue" 
> 

<TextView 
style="@style/ShowTableRowTo" 
> 

<TextView 
android:id="@+id/showHumidityH" 
style="@style/ShowTableRowValue2" 
> 

<TextView 
android:text="@string/percent" 
style="@style/ShowTableRowUnit" 
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> 
</LinearLayout> 


<LinearLayout 
android:orientation="horizontal" 
style="@style/ShowTableRow" 

> 

<TextView 
android:text="@string/dewpoint" 
style="@style/ShowTableRowLabel" 
> 

<TextView 
android:id="@+id/showDewpointL" 
style="@style/ShowTableRowValue" 
> 

<TextView 
style="@style/ShowTableRowTo" 
> 

<TextView 
android:id="@+id/showDewpointH" 
style="@style/ShowTableRowValue2" 
> 

<TextView 
android:text="@string/degreesc" 
style="@style/ShowTableRowUnit" 
> 

</LinearLayout> 


<LinearLayout 
android:orientation="horizontal" 
style="@style/ShowTableRow" 

> 

<TextView 
android:text="@string/density" 
style="@style/ShowTableRowLabel" 
> 

<TextView 
android:id="@+id/showDensityL" 
style="@style/ShowTableRowValue" 
> 

<TextView 
style="@style/ShowTableRowTo" 
> 

<TextView 
android:id="@+id/showDensityH" 
style="@style/ShowTableRowValue2" 
> 

<TextView 
android:text="@string/gm3" 
style="@style/ShowTableRowUnit" 
> 
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<LinearLayout 
android:paddingTop-"15dp" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
> 
<Button 
android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
android:id="@+id/ok" 
android:text="@string/ok" 
style="@style/BigFont" 
android:layout_weight="1" 
> 
<Button 
android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
android:id="@+id/save" 
android:text="@string/save" 
style="@style/BigFont" 
android:layout_weight="1" 
> 
</LinearLayout> 
</LinearLayout> 


程序 文件 ShowReadingActivity.java 的 功能 是 获取 并 显示 当前 温度 、 湿 度 、 露 点 和 水 密度 的 值 ， 具 
体 实现 代码 如 下 所 示 。 


public class ShowReadingActivity extends Activity 
{ 


/** Called when the activity is first created. */ 
@Override 
public void onCreate(Bundle savedinstanceState) 
{ 
super.onCreate(savedinstanceState); 
setContentView(R.layout.showreading); 


double temp = getIntent().getDoubleExtra(EXTRA TEMP, 0.0); 

float tempError = getintent().getFloatExtra/(EXTRA TEMP ERROR, 0.00); 

double humidity = getlntent().getDoubleExtra(EXTRA HUMIDITY, 0.0); 

float humidityError = getlntent().getFloatExtra(EXTRA HUMIDITY ERROR, 0.0f); 


ClimateData data = new ClimateData(temp, tempError, humidity, humidityError); 


FieldValue value = data.getField(FIELD TEMPERATURE); 
((TextView)findViewByld(R.id.showTempL)).setText( 
String.format("%.1f", value.getMin())); 
((TextView)findViewByld(R.id.showTempH)).setText( 
String.format("%.1f", value.getMax())); 
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value = data.getField(FIELD_HUMIDITY); 
((TextView)findViewByld(R.id.showHumidityL)).setText( 
String.format("%.1f", value.getMin())); 
((TextView)findViewByld(R.id.showHumidityH)).setText( 
String.format("%.1f", value.getMax())); 


value = data.getField(FIELD DEWPOINT); 
((TextView)findViewByld(R.id.showDewpointL)).setText( 
String. format("%.1f", value.getMin())); 
((TextView)findViewByld(R.id.showDewpointH)).setText( 
String.format("%.1f", value.getMax())); 


value = data.getField(FIELD DENSITY); 
((TextView )findViewByld(R.id.showDensityL)).setText( 
String.format("%.2f", value.getMin())); 
((TextView)findViewByld(R.id.showDensityH)).setText( 
String.format("%.2f", value.getMax())); 


findViewByld(R.id.ok).setOnClickListener(new OnClickListener() 
{ 

@Override 

public void onClick(View v) 

{ 

Intent intent = new Intent(); 

intent.putExtra(EXTRA_SAVEBANK, -1); 
setResult(RESULT_OK, intent); 
finish(); 


}); 


findViewByld(R.id.save).setOnClickListener(new OnClickListener() 

{ 
@Override 
public void onClick(View v) 
{ 
// User has selected to save the reading 
Intent intent = new Intent(ShowReadingActivity.this, SaveReadingActivity.class); 
intent.putExtra(EXTRA_TEMP, getintent().getDoubleExtra(EXTRA TEMP, 0.0)); 
intent.putExtra(EXTRA TEMP ERROR, getintent().getFloatExtra(EXTRA_TEMP_ERROR, 0.0f)); 
intent.putExtra(EXTRA HUMIDITY, getlntent().getDoubleExtra(EXTRA HUMIDITY, 0.0)); 
intent.putExtra(EXTRA. HUMIDITY ERROR, getlntent().getFloatExtra(EXTRA HUMIDITY ERROR, 
0.0f)); 
startActivityForResult(intent, 0); 
) 

}); 

} 


@Override 
protected void onActivityResult(int requestCode, int resultCode, Intent data) 


£ 
II Pass result data through, and finish 


@ 
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if(resultCode == RESULT OK) 
{ 
setResult(resultCode, data); 
finish(); 
} 

} 


} 
系统 显示 当前 值 界 面 的 执行 效果 如 图 12-3 所 示 。 


图 12-3 ”显示 当前 值 界面 的 执行 效果 
12.4 保存 当前 数值 


Фи 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 12 章 \ 保 存 当 前 数值 .avi 
如 果 在 当前 值 界 面 中 单 击 Save 按钮 ， 系 统 会 保存 当前 的 测试 数值 。 本 节 将 详细 讲解 本 系统 保存 当 
前 数值 模块 的 具体 实现 流程 。 


1241 实现 布局 文件 


布局 文件 savereading.xml 的 功能 是 保存 系统 当前 测试 的 湿度 和 温度 值 ， 具 体 实现 代码 如 下 所 示 。 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="fill_ parent" 
android:layout_height="fill_ parent" 
android:padding="10dp" 
> 
<TableLayout 
android:layout_width="fill_ parent" 
android:layout_height="fill_ parent" 
android:layout_weight="1" 
android:stretchColumns="0, 1" 
> 
<TableRow> 
<Button 
android:id="@+id/stored1" 
android:textColor="@color/stored1" 
style="@style/StoredButton" 
P 
<Button 
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android:id="@+id/stored2" 
android:textColor="@color/stored2" 
style="@style/StoredButton" 
> 
</TableRow> 
<TableRow> 
<Button 
android:id="@+id/stored3" 
android:textColor="@color/stored3" 
style="@style/StoredButton" 
> 
<Button 
android:id="@+id/stored4" 
android:textColor="@color/stored4" 
style="@style/StoredButton" 
> 
</TableRow> 
<TableRow> 
<Button 
android:id="@+id/stored5" 
android:textColor="@color/stored5" 
style="@style/StoredButton" 
[> 
<Button 
android:id="@+id/stored6" 
android:textColor="@color/stored6" 
style="@style/StoredButton" 
> 
</TableRow> 
</TableLayout> 
</LinearLayout> 


12.4.2 ”实现 SaveReadingActivity 


程序 文件 SaveReadingActivity java 的 功能 是 保存 当前 的 值 到 数据 库 中 ， 有 具体 实现 代码 如 下 所 示 。 


public class SaveReadingActivity extends Activity 


{ 
/** Called when the activity is first created. */ 


@Override 
public void onCreate(Bundle savedinstanceState) 
{ 

super.onCreate(savedinstanceState); 
setContentView(R.layout.savereading); 


int[] ids = ( R.id.stored1, R.id.stored2, R.id.stored3, 
R.id.stored4, R.id.stored5, R.id.stored6 }; 

for(int і=0; i<6; i++) 

{ 


final int storeNum = i; 
@ 


Button storedButton = (Button)findViewByld(ids[i]); 
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storedButton.setText(HumidityActivity.getBankName(this, i)); 
storedButton.setOnClickListener(new View.OnClickListener() 
{ 
@Override 
public void onClick(View v) 
{ 
Intent intent = new Intent(); 
intent.putExtra(EXTRA TEMP, getintent().getDoubleExtra(EXTRA_ TEMP, 0.0)); 
intent.putExtra(EXTRA TEMP ERROR, getlntent().getFloatExtra(EXTRA TEMP _ 
ERROR, 0.0f)); 
intent.putExtra(EXTRA HUMIDITY, getintent().getDoubleExtra(EXTRA HUMIDITY, 0.0)); 
іпіепі.риіЕхіга(ЕХТКА HUMIDITY ERROR, getlIntent().getFloatExtra(EXTRA _ 
HUMIDITY ERROR, 0.09); 
intent.putExtra(EXTRA_SAVEBANK, storeNum); 
setResult(RESULT OK, intent); 
finish(); 


» 


12.5 图形 化 显示 测试 结果 


知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 12 章 \ 图 形 化 显示 测试 结果 .avi 
布局 文件 showrecords.xml 的 功能 是 以 图 形 化 的 方式 显示 当前 的 测试 结果 , 具体 实现 代码 如 下 所 示 。 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 

android:id="@+id/layout" 

android:orientation="vertical" 

android:layout_width="fill_ parent" 

android:layout_height="fill_ parent" 

android:padding="0dp" 

> 

<!-- Graph component added programatically --> 
</LinearLayout> 
程序 文件 ShowRecordsActivity.java 的 功能 是 监听 用 户 的 操作 事件 ， 根 据 用 户 的 选项 绘制 图 形 化 界 
以 图 形 化 方式 显示 当前 的 检测 结果 值 。 文 件 ShowRecordsActivityjava 的 具体 实现 代码 如 下 所 示 。 
public class ShowRecordsActivity extends Activity 
И 


private int bank; 

private DataPoint[ ] data; 
private RecordsGraph graph; 
private int graphField; 


private int nearestPointIndex; 
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private final static String PREFS_CURRENT_GRAPH = "currentGraph"; 


public final static float[ ] MAX RANGE = { 40.01, 100.0f, 40.01, 50.0f }; 

public final static float] ] RANGE STEP = { 5.0f, 5.0f, 5.0f, 5.0f}; 

public final static int[ ] FIELD LABEL = { R.string.temp, R.string.humidity, 
R.string.dewpoint, R.string.density }; 

public final static int[ ] FIELD UNIT = { R.string.degreesc, R.string.percent, 
R.string.degreesc, R.string.gm3 }; 


private final static float HIT_RADIUS = 48; 
private final static float GRAPH_PADDING = 10; 


private final static long ONE_DAY = 24L * 3600L * 1000L; 
private final static int DIALOG_POINT=1, DIALOG_NAME=2, DIALOG_DELETE=3; 


private static class DataPoint 
{ 


long javaTime; 
ClimateData data; 


private DataPoint(long javaTime, ClimateData data) 
( 


this.javaTime = javaTime; 
this.data = data; 


} 


private class RecordsGraph extends View 


{ 
private float xScale, yScale, left, bottom, density; 
private long startTime; 


public RecordsGraph() 


{ 

super(ShowRecordsActivity.this); 

setLayoutParams(new LinearLayout.LayoutParams( 

LayoutParams.FILL PARENT, LayoutParams.FILL PARENT, 1.0f)); 

) 
@Override 
public boolean onTouchEvent(MotionEvent event) 
{ 

switch(event.getAction()) 

{ 


case MotionEvent.ACTION DOWN: 

case MotionEvent.ACTION MOVE: 
updateNearestPoint(event.getX(), event.getY()); 
return true; 

case MotionEvent.ACTION UP: 
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updateNearestPoint(event.getX(), event.getY()); 
if(nearestPointIndex != -1) 


{ 
showDialog(DIALOG_POINT); 
} 
nearestPointIndex = -1; 
invalidate(); 
return true; 
} 
return false; 


} 


private void updateNearestPoint(float x, float y) 
{ 
II Crap algorithm, but let's just try all the points within any kind of 
II range. 
float radius = HIT_RADIUS * density; 
float bestDiff = radius * radius; 
int bestIndex = -1; 
for(int i=0; i<data.length; i++) 
{ 
11 Get X point and check if within range 
float pointX = (float)(data[i].javaTime - startTime) * xScale + left; 


if (pointX > x + radius) 
{ 
һгеак; 
} 
if (pointX < x - radius) 
{ 
continue; 
} 
11 Find Y point 


FieldValue field = data[i].data.getField(graphField); 
float pointY = bottom - field.getMeasured() * yScale; 


11 Work out difference (= distance squared) 
float diff = (pointY - y) * (pointY - y) + (pointX - x) * (pointX - x); 


if (diff < bestDiff) 
{ 
bestDiff = diff; 
bestlndex = i; 
} 
} 
if(bestlndex != nearestPointIndex) 
{ 
nearestPointlndex = bestlndex; 
invalidate(); 
) 
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} 


@Override 
protected void onDraw(Canvas canvas) 


{ 


DisplayMetrics metrics = new DisplayMetrics(); 
getWindowManager().getDefaultDisplay().getMetrics(metrics); 
density = metrics.density; 

float blobRadius = 2f * density; 

float padding = GRAPH_PADDING * density; 


II Clear to off-black 
canvas.drawColor(Color.argb(255, 30, 30, 30)); 


/ Get available width and height for graph 

float w = getWidth() - padding*2, h = getHeight() - padding*2; 
left = padding; 

bottom = getHeight() - padding; 


11 Draw axes in grey 

Paint grey = new Paint(Paint.ANTI ALIAS FLAG); 
grey.setColor(Color.argb(255, 128, 128, 128)); 

canvas.drawLine(left, bottom, left+w, bottom, grey); 
canvas.drawLine(left, bottom, left, bottom-h, grey); 
canvas.drawLine(left, bottom-h, left 1.5f*blobRadius, bottom-h, grey); 


II Work out Y scaling 
float actualMax = 0; 
for(int i=0; i«data.length; i++) 


{ 
float value = data[i].data.getField(graphField).getMax(); 
if(value > actualMax) 
{ 
actualMax = value; 
} 
} 


float range = MAX RANGE([graphField]; 

if(data.length == 0) 

i actualMax 7 range; 

ВЕК - RANGE_STEP{graphField] > actualMax) 
: range -= RANGE_STEP{graphField]; 

} 


yScale = h / range; 


II Draw scale text 
String max = String.format("%.0f", range); 
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grey.setTextSize(12f * density); 

Rect bounds = new Rect(); 

grey.getTextBounds(max, 0, max.length(), bounds); 

canvas.drawText(max, left * blobRadius * 2 * density, 
bottom - h - bounds.top, grey); 


II If there is no data, stop here 
if(data.length == 0) 
{ 

return; 


} 


II Work out X scaling 
startTime = data[0].javaTime; 
long timeRange = data[data.length - 1].javaTime - startTime; 
if(timeRange == 0) 
{ 
timeRange = 1; 
} 
xScale = w / (float)timeRange; 


11 Draw each point 

Paint white = new Paint(Paint.ANTI ALIAS FLAG); 
white.setColor(Color.argb(255, 255, 255, 255)); 

Paint faintLine = new Paint(Paint.ANTI ALIAS FLAG); 
faintLine.setColor(Color.argb(160, 0, 255, 0)); 

for(int i=0; i<data.length; i++) 


( 
float x = (float)(data[i].javaTime - startTime) * xScale; 
FieldValue field = data[i].data.getField(graphField); 
float yMin = field.getMin() * yScale, yMax = field.getMax() * yScale; 
float y = field.getMeasured() * yScale; 
if (==nearestPointIndex) 
{ 
Paint faint = new Paint(Paint.ANTI ALIAS FLAG); 
faint.setColor(Color.argb(64,255,255,255)); 
canvas.drawCircle(x + left, bottom - y, blobRadius*20, faint); 
) 
canvas.drawLine(x + left, bottom - yMin, x + left, bottom - yMax, faintLine); 
canvas.drawCircle(x + left, bottom - y, blobRadius, white); 
} 
} 
@Override 
protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) 
{ 
int w; 
if(MeasureSpec.getMode(widthMeasureSpec) == MeasureSpec.UNSPECIFIED) 
{ 
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w = 100; 
} 


else 
{ 

w = MeasureSpec.getSize(widthMeasureSpec); 
} 


int h; 
if(MeasureSpec.getMode(heightMeasureSpec) == MeasureSpec.UNSPECIFIED) 
{ 
h = 100; 
} 
else 
{ 
h = MeasureSpec.getSize(heightMeasureSpec); 
} 


setMeasuredDimension(w, h); 


} 


/** Called when the activity is first created. */ 
@Override 
public void onCreate(Bundle savedinstanceState) 


{ 


super.onCreate(savedinstanceState); 


II Get current bank and set title 
bank = getintent().getintExtra(HumidityActivity.EXTRA SAVEBANK, -1); 


loadData(); 


setContentView(R.layout.showrecords); 
LinearLayout layout = (LinearLayout)findViewByld(R.id.layout); 


graph = new RecordsGraph(); 
layout.addView(graph, 0); 


II Get default field 

setField(getSharedPreferences("com.leafdigital.humidity", MODE PRIVATE).getlnt( 
PREFS CURRENT GRAPH, FIELD HUMIDITY); 

} 


private void loadData() 
{ 
11 Load records. (Note: This uses a writable database because it might need 
II to do a db version update, so it has to be able to write) 
SQLiteDatabase db = new RecordsOpenHelper(this).getWritableDatabase(); 
Cursor cursor = db.query( 
"readings", new String[ ] { "javatime", "temperature", "temperature error", 
"humidity", "humidity error" }, 
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"bank = ?", newString[] (bank + "" }, null, null, "javatime"); 
int count = cursor.getCount(); 
data = new DataPoint[count]; 
for(int i=0; i<count; i++) 
{ 
cursor.moveToNext(); 
data[i] = new DataPoint(cursor.getLong(0), new ClimateData(cursor.getFloat(1), 
cursor.getFloat(2),cursor.getFloat(3),cursor.getFloat(4))); 
} 
cursor.close(); 
db.close(); 


11 Clear other fields that depend on data 
nearestPointIndex = -1; 


} 
private void setField(int field) 
{ 
this.graphField = field; 
setTitle(HumidityActivity.getBankName(this, bank) + " - " + getString(FIELD_LABEL/field]) 
+" (" + getString(FIELD UNIT[field]) + ")"); 
graph. invalidate(); 
SharedPreferences prefs = getSharedPreferences("com.leafdigital.humidity", MODE PRIVATE); 
if(prefs.getInt((PREFS_CURRENT_GRAPH, FIELD HUMIDITY) != field) 
{ 
if(field == FIELD_HUMIDITY) 
{ 
prefs.edit().remove(PREFS_CURRENT_GRAPH).commit(); 
} 
else 
{ 
prefs.edit().putInt(PREFS_ CURRENT GRAPH, field).commit(); 
} 
} 
} 
@Override 
public boolean onCreateOptionsMenu(Menu menu) 
{ 
Menulnflater inflater = getMenulnflater(); 
inflater.inflate(R.menu.showrecords, menu); 
return true; 
} 
@Override 


public boolean onPrepareOptionsMenu(Menu menu) 


{ 


int id = -1; 
switch(graphField) 
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{ 

case FIELD_TEMPERATURE : 
id = R.id.temp; 
break; 

case FIELD HUMIDITY : 
id = R.id.humidity; 
break; 

case FIELD_DEWPOINT : 
id = R.id.dewpoint; 
break; 

case FIELD_DENSITY : 
id = R.id.density; 
break; 

} 


menu.findltem(id).setChecked(true); 


menu.findltem(R.id.delete).setEnabled(data.length != 0); 

long now 7 System.currentTimeMillis(); 

menu.findltem(R.id.deletebefore1d).setEnabled(data.length»0 
&& now - data[0].javaTime > 1 * ONE DAY); 

menu.findltem(R.id.deletebefore7d).setEnabled(data.length»0 
&& now - data[0].javaTime > 7 * ONE DAY); 

menu.findltem(R.id.deletebefore30d).setEnabled(data.length»0 
&& now - data[0].javaTime > 30 * ONE DAY); 


return super.onPrepareOptionsMenu(menu); 


} 


@Override 
public boolean onOptionsltemSelected(Menultem item) 
{ 
Switch(item.getltemld()) 
{ 
case R.id.temp : 
setField(FIELD TEMPERATURE); 
return true; 
case R.id.humidity : 
setField(FIELD HUMIDITY); 
return true; 
case R.id.dewpoint : 
setField(FIELD DEWPOINT); 
return true; 
case R.id.density : 
setField(FIELD DENSITY); 
return true; 
case R.id.name : 
showDialog(DIALOG МАМЕ); 
return true; 
case R.id.deletelast : 
deleteData(data[data.length-1].java Time-1, getString(R.string.deletelast), true); 
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return true; 

case R.id.deletebefore1d : 
deleteData(System.currentTimeMillis() - ONE DAY, getString(R.string.deletebefore1d), false); 
return true; 

case R.id.deletebefore7d : 
deleteData(System.currentTimeMillis() - 7 * ONE DAY, getString(R.string.deletebefore7d), false); 
return true; 

case R.id.deletebefore30d : 
deleteData(System.currentTimeMillis() - 30 * ONE DAY, getString(R.string.deletebefore30d), false); 
return true; 

case R.id.deleteall : 
deleteData(System.currentTimeMillis() + 1, getString(R.string.deleteall), false); 


return true; 
default: 
return super.onOptionsltemSelected(item); 
} 
} 
@Override 


protected Dialog onCreateDialog(int id) 


{ 


11 Create dialog 

final Dialog dialog = new Dialog(this); 

switch(id) 

{ 

case DIALOG POINT : 
dialog.setContentView(R.layout.pointdialog); 
View ok = dialog. findViewByld(R.id.ok); 
ok.setOnClickListener(new OnClickListener() 


{ 
@Override 
public void onClick(View v) 
{ 
dialog.cancel(); 
} 
» 
break; 


case DIALOG NAME : 
dialog.setContentView(R.layout.namedialog); 
dialog.setTitle(R.string.name); 
final EditText edit = (EditText)dialog.findViewByld(R.id.name); 
final View okName = dialog. findViewByld(R.id.ok); 
okName.setOnClickListener(new OnClickListener() 
{ 
@Override 
public void onClick(View v) 
{ 
String name = edit.getText().toString(); 
SharedPreferences.Editor editor = getSharedPreferences("com.leafdigital.humidity", 
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MODE_PRIVATE).edit(); 
editor.putString(PREFS BANK NAME + bank, name); 
editor.commit(); 
dialog.dismiss(); 
setField(graphField); 
) 
y 
edit.addTextChangedListener(new TextWatcher() 
{ 
@Override 
public void onTextChanged(CharSequence s, int start, int before, int count) 
{ 
} 


@Override 

public void beforeTextChanged(CharSequence s, int start, int count, int after) 
{ 

} 


@Override 
public void afterTextChanged(Editable s) 
{ 
int length = edit.getText().length(); 
okName.setEnabled(length <= 6 && length >= 1); 
} 
» 


break; 


case DIALOG DELETE: 
AlertDialog.Builder builder = new AlertDialog.Builder(this); 
builder.setMessage(getString(R.string.confirmdelete)); 
builder.setPositiveButton(getString(R.string.delete), 
new DialogInterface.OnClickListener() 


{ 
@Override 
public void onClick(DialogInterface dialog, int which) 
{ 
confirmDelete(); 
dialog.dismiss(); 
} 
}); 


builder.setNegativeButton(getString(R.string.cancel), 
new DialogInterface.OnClickListener() 


{ 
@Override 
public void onClick(DialogInterface dialog, int which) 
{ 
dialog.cancel(); 
} 
» 
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builder.setTitle("Placeholder"); 
return builder.create(); 
} 
return dialog; 
} 


@Override 
protected void onPrepareDialog(int id, Dialog dialog) 
{ 
switch(id) 
{ 
case DIALOG POINT : 
preparePointDialog(dialog); 
break; 
case DIALOG NAME : 
prepareNameDialog(dialog); 
break; 
case DIALOG DELETE : 
prepareDeleteDialog(dialog); 
break; 


} 


private void preparePointDialog(Dialog dialog) 

{ 
11 Get data 
DataPoint point = data[nearestPointIndex]; 
FieldValue field 7 point.data.getField(graphField); 


II Set title to date 
SimpleDateFormat date = new SimpleDateFormat("yyyy-MM-dd HH:mm"); 
dialog. setTitle(date.format(new Date(point.javaTime))); 


II Set icon 

ImageView image = (ImageView)dialog.findViewByld(R.id.icon); 

int icon 7 -1; 

switch(graphField) 

{ 

case FIELD_TEMPERATURE: 
icon = R.drawable.menu_temp; 
break; 

case FIELD HUMIDITY: 
icon = R.drawable.menu humidity; 
break; 

case FIELD DEWPOINT: 
icon = R.drawable.menu dewpoint; 
break; 

case FIELD DENSITY: 
icon = R.drawable.menu density; 
break; 
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} 


image.setlmageResource(icon); 


II Set units 
for(int unitld : new іп ] ( R.id.unit1, R.id.unit2, R.id.unit3 )) 
{ 
((TextView)dialog.find ViewByld(unitld)).setText(getString(FIELD UNIT[graphField])); 
} 


II Set actual values 

String format = graphField == FIELD_DENSITY ? "%.2f" : "9.1"; 

((TextView)dialog.findViewByld(R.id.minValue)).setText( 
String.format(format, field.getMin())); 

((TextView)dialog.findViewByld(R.id.estValue)).setText( 
String.format(format, field.getMeasured())); 

((TextView)dialog.findViewByld(R.id.maxValue)).setText( 
String.format(format, field.getMax())); 


} 
private void prepareNameDialog(Dialog dialog) 
{ 
((EditText)dialog.findViewByld(R.id.name)).setText( 
HumidityActivity.getBankName(this, bank)); 
((Button)dialog.find ViewByld(R.id.ok)).setEnabled(true); 
) 
private void prepareDeleteDialog(Dialog dialog) 
{ 
dialog.setTitle(deleteMessage); 
) 
private long deleteTime; 
private boolean deleteAfter; 
private String deleteMessaqe; 
private void deleteData(long time, String message, boolean after) 
£ 
II This is crappy, but | have to call showDislog and then use this stuff 
Il later. 
this.deleteTime = time; 
this.deleteMessage = message; 
this.deleteAfter = after; 
showDialog(DIALOG DELETE); 
} 
private void confirmDelete() 
{ 


SQLiteDatabase db = new RecordsOpenHelper(this).getWritableDatabase(); 
db.delete("readings", "javatime " + (deleteAfter ? ">" : "«") 

+"? AND bank = ?", new String[ ] ( deleteTime + "", bank + ""}); 
db.close(); 
loadData(); 
graph.invalidate(); 


} 
} 
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当 用 户 按 下 设备 中 的 MENU 后 ， 会 在 屏幕 下 方 弹出 6 个 操作 选项 ， 系 统 会 以 图 形 化 界面 效果 显示 


检测 结果 ， 执 行 后 效果 如 图 12-4 所 示 。 


ае em 
humidity(%) — 


Temperature Relative humidity 


4 š: 
Dewpoint Water density 
Ó @ 


Name data Delete data 


图 12-4 执行 效果 
12.6 湿度 跟踪 器 


Фи 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 12 章 \ 湿 度 跟踪 器 .avi 


本 系统 检测 湿度 功能 是 通过 开源 代码 湿度 跟踪 器 实现 的 , 开源 文件 ClimateData java 的 具体 实现 代 


码 如 下 所 示 。 
public class ClimateData 
{ 
public final static int FIELD_TEMPERATURE=0, FIELD_HUMIDITY=1, 
FIELD_DEWPOINT=2, FIELD_DENSITY=3; 


private double[ ] measured = new double[4], min = new double[4], max = new double[4]; 


public static class FieldValue 


{ 


private float measured, min, max; 


private FieldValue(int field, double[ ] measured, double[ ] min, double[ ] max) 


{ 
this.measured = (float)measured[field]; 
this.min = (float)minffield]; 
this.max = (float)max[field]; 

} 


public float getMeasured() 
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{ 


return measured; 


} 


public float getMin() 
{ 


return min; 


} 


public float getMax() 
{ 


} 


return max; 


} 


public ClimateData(double temp, float tempError, double humidity, float humidityError) 
{ 

measured[FIELD TEMPERATURE] = temp; 

min[FIELD TEMPERATURE] = Math.max(0, temp - tempError); 

max[FIELD TEMPERATURE] = Math.min(40, temp + tempError); 


measured[FIELD HUMIDITY] = humidity; 
min[FIELD HUMIDITY] = Math.max(1, humidity - humidityError); 
max[FIELD HUMIDITY] = Math.min(100, humidity + humidityError); 


measured[FIELD DEWPOINT] = getDewpoint(measured); 
min[FIELD DEWPOINT] = getDewpoint(min); 
max[FIELD DEWPOINT] = getDewpoint(max); 


measured[FIELD DENSITY] = getDensity(measured); 
min[FIELD DENSITY] = getDensity(min); 
max[FIELD DENSITY] = getDensity(max); 

) 


private static double getDewpoint(double[ ] values) 
{ 
double temp = values[FIELD_ TEMPERATURE]; 
double humidity = values[FIELD_HUMIDITY]; 


11 Dewpoint valid up to 60 degrees, from 

II http://en.wikipedia.org/wiki/Dew_point#Calculating_the_dew_point 
double a = 17.271, b = 237.2; 

double gamma = ((a * temp) / (b + temp)) + Math.log(humidity/100.0); 
return b * gamma / (a - gamma); 


) 


private static double getDensity(double[ ] values) 


{ 
double temp = values[FIELD TEMPERATURE]; 
double humidity = values[FIELD HUMIDITY]; 
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II Approximate saturated vapour density valid up to 40 degrees, from 
11 http://hyperphysics.phy-astr.gsu.edu/hbase/kinetic/relhum.html#c3 
double saturated = 5.018 + 0.32321 * temp + 0.0081847 * temp * temp 
+ 0.00031243 * temp * temp * temp; 
return saturated * (humidity / 100.0); 
) 


public FieldValue getField(int field) 
{ 


return new FieldValue(field, measured, min, max); 
} 
} 
到 此 为 止 ， 本 实例 的 主要 功能 模块 介绍 完毕 。 和 数据 库 操作 相关 的 代码 请 读者 参阅 本 书 附 带 光 盘 
中 的 具体 源码 ， 为 节省 篇 幅 ， 在 此 不 再 进行 详细 讲解 。 


第 13 章 小 米 录 音 


在 过 去 的 几 年 中 ， 小 米 手机 创造 了 国产 Android 手机 的 销售 神话 。 在 小 米 手机 中 内 置 了 一 个 UI 界 
面 优美 、 功 能 强大 的 录音 机 程序 : MIUI 录 音 机 。 在 2012 年 ，MIUI 录音 机 程序 完全 开源 ， 目 的 是 集 思 
广 益 ， 吸 引 广 大 程序 员 提 高 其 功能 和 效果 。 本 章 将 详细 讲解 MIUI 录音 机 程序 的 基本 源码 ， 为 读者 学 
习 本 书后 面 的 知识 打下 基础 。 
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ы 知识 点 讲解 : 光盘: 视频 \ 知 识 点 第 13 章 \ 系 统 介绍 .avi 

MIUI 录音机 是 一 款 基于 Android 原生 录音 机 开发 的 产品 , 与 Android 系统 自 带 的 原生 录音 机 相 比 ， 
MIUI 录音 机 在 UI、 交 互 方式 和 录音 效果 上 都 有 较 大 的 提升 ， 其 磁带 的 显示 效果 更 是 深 受 广大 用 户 的 
好 评 。MIUI 录音 机 由 MIUI 团队 (www.miui.com) 发 起 并 贡献 第 一 批 代码 ， 遵 循 NOTICE 文件 所 描述 
的 开源 协议 ， 开 源 后 为 MiCode 社区 (www.micode.net) 所 拥有 ， 并 由 社区 发 布 和 维护 。 

Вир 反馈 和 跟踪 ， 可 访问 如 下 所 示 的 GitHub 地 址 ， 如 图 13-1 所 示 。 

https://github.com/MiCode/SoundRecorder/issues?sort=created&direction=desc&state=open 


GitHub ^о © Explore Features Enterprise Blog 
MiCode / SoundRecorder 4 
MIU 尿 音 机 社区 开源 版 (Community edition of MIUI ScundRecorder) http://micode netiforum-39-1 html 


B README 


EE README 


13-1 GitHub 地 址 (保存 开源 代码 的 地 址 ) 


功能 建议 和 综合 讨论 ， 可 访问 如 下 所 示 的 MiCode 地 址 ， 如 图 13-2 Aras. 
http://micode.net/forum-39-1.html 
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图 13-2 ”用户 和 开发 者 讨论 区 


132 ”系统 主 界面 


知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 13 章 \ 系 统 主 界面 .avi 
MIUI 录 音 机 的 主 界面 十 分 美观 ， 如 图 13-3 所 示 。 


中 国联 通 会 ll C 加 22:01 


O Ө 


图 13-3 系统 主 界面 
在 本 节 的 内 容 中 ， 将 详细 讲解 MIUI 录音 机 主 界面 的 具体 实现 流程 。 


13.21 实现 UI 布局 
系统 主 界面 的 UI 布局 文件 是 main.xml， 具 体 实现 流程 如 下 所 示 。 


CD 设置 指定 的 图 片 background.png 为 系统 主 界面 的 背景 图 像 ， 有 具体 实现 代码 如 下 所 示 。 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
® 
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android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation="vertical" > 


<LinearLayout 
android:layout_width="fill_ parent" 
android:layout height-"Odip" 
android:layout_weight="1" 
android:background="@drawable/background" 
android:orientation="vertical" > 
(2) 在 屏幕 项 部 显示 计时 时 间 ， 有 具体 实现 代码 如 下 所 示 。 
<LinearLayout 
android:id="@+id/time_calculator" 
android:layout_width="fill_parent" 
android:layout height-"Odip" 
android:layout_weight="4" 
android:gravity="center" 
android:orientation-"horizontal" 
android:paddingTop-"40dip" > 
</LinearLayout> 
(3) 使 用 FrameLayout 插件 实现 动态 动画 效果 ,首先 使 用 指定 图 片 tape_bottom.png 生成 一 个 磁带 
效果 ， 然 后 使 用 图 片 wheel_left.png 生成 左 磁带 的 转动 效果 ， 使 用 图 片 wheel_right.png 生成 右 磁带 的 转 
动 效果 。 有 具体 实现 代码 如 下 所 示 。 
<FrameLayout 
android:layout_width="wrap_content" 
android:layout_height="Wrap_content" 
android:layout_gravity="center" > 


«ImageView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:src="@drawable/tape_bottom" /> 


<net.micode.soundrecorder.WheellmageView 
android:id="@+id/wheel_left" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout  gravity-"left|top" 
android:layout marginLeft-"44dip" 
android:layout marginTop-"60dip" 
android:src="@drawable/wheel_left" /> 


<net.micode.soundrecorder.WheellmageView 
android:id="@+id/wheel_right" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout_gravity="right|top" 
android:layout_marginRight="45dip" 
android:layout marginTop-"60dip" 
android:src="@drawable/wheel_right" /> 


@ 


<net.micode.soundrecorder.WheellmageView 
android:id="@+id/wheel_small_left" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="left|bottom" 
android:layout marginBottom-"15dip" 
android:layout marginLeft-"30dip" 
android:src-"(odrawable/wheel small left" /> 


«net.micode.soundrecorder.WheellmageView 
android:id-" (9) *id/wheel small right" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout_gravity="right|bottom" 
android:layout marginBottom-"15dip" 
android:layout marginRight-"30dip" 
android:src-"()drawable/wheel small right" /> 


«ImageView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:src="@drawable/tape_top" /> 


<LinearLayout 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="left|top" 
android:layout_marginLeft="55dip" 
android:layout_marginTop="39dip" 
android:orientation="vertical" > 


<LinearLayout 
android:layout_width="0px" 
android:layout_height="0px" 
android:focusable="true" 
android:focusableln TouchMode-"true" /> 


<net.micode.soundrecorder.RecordNameEditText 
android:id="@+id/file_name" 
android:layout_width="220dip" 
android:layout_height="25dip" 
android:background="#00000000" 
android:selectAllOnFocus="true" 
android:singleLine="true" /> 

</LinearLayout> 

</FrameLayout> 


(4) 生成 屏幕 中 间 的 播放 进度 条 效果 ， 在 进度 条 前 面 显示 开始 时 间 “00:00”， 在 进度 条 后 方 显示 


当前 音频 的 时 长 。 具 体 实现 代码 如 下 所 示 。 


<LinearLayout 
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android:layout width-"fill parent" 
android:layout height-"Odip" 
android:layout_weight="3" 
android:gravity="center" 
android:orientation="vertical" > 


<LinearLayout 
android:id="@+id/vumeter_layout" 
android:layout_width="fill_parent" 
android:layout height-"Odip" 
android:layout_weight="1" 
android:gravity="center" 
android:orientation-"horizontal" > 

</LinearLayout> 


<LinearLayout 


android:id="@+id/play_seek_bar_layout" 


android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:gravity="center" 
android:orientation="horizontal" > 


<TextView 
android:id="@+id/starttime" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:paddingLeft-"10dip" 


android:textAppearance="?android:attr/textAppearanceSmall" 


android:textColor="#7 FFFFFFF" /> 


<SeekBar 
android:id="@+id/play_seek_bar" 
android:layout_width="Odip" 
android:layout_height="wrap_content" 
android:layout_weight="1" 
android:orientation-"horizontal" 
android:paddingLeft="10dip" 
android:paddingRight="1 Odip" /> 


<TextView 
android:id="@+id/totaltime" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:paddingRight-"1 Odip" 


android:textAppearance="?android:attr/textAppearanceSmall" 


android:textColor="#7 FFFFFFF" /> 
</LinearLayout> 
</LinearLayout> 
</LinearLayout> 


执行 效果 如 图 13-4 所 示 。 


6. 


图 13-4 进度 条 效果 


(5) 分 别 生 成 屏幕 底部 的 播放 、 和 暂停 、 删 除 、 录 音 等 操作 按钮 ， 
<LinearLayout 
android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
android:gravity="center" 
android:background="@drawable/background_key" > 


<LinearLayout 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:orientation-"horizontal" > 


<ImageButton 
android:id="@+id/newButton" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:background="@drawable/btn_new" /> 


<ImageButton 
android:id="@+id/finishButton" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:background="@drawable/btn_finish" 
android: visibility="gone" /> 


<ImageButton 
android:id="@+id/recordButton" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:background-"(gdrawable/btn record" /> 


«ImageButton 
android:id="@+id/stopButton" 
android:layout width-"wrap content" 
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具体 实现 代码 如 下 所 示 。 
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android:layout height-"wrap content" 
android:background="@drawable/btn_stop" 
android: visibility="gone" /> 


<ImageButton 
android:id="@+id/playButton" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:background-"(drawable/btn play" 
android:visibilityz"gone" /> 


<ImageButton 
android:id="@+id/pauseButton" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:background-"(drawable/btn pause" 
android:visibilityz"gone" /> 


<ImageButton 
android:id="@+id/deleteButton" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:background="@drawable/btn_delete" /> 
</LinearLayout> 


</LinearLayout> 


</LinearLayout> 


13.2.2 ”实现 程序 文件 


系统 主 界面 的 程序 文件 是 SoundRecorderjava， 功 能 是 加 载 UI 文件 中 设置 的 布局 控件 ， 监 听 用 户 
在 主 界面 的 操作 ， 并 根据 操作 执行 对 应 的 事件 处 理 程序 。 文 件 SoundRecorderjava 的 具体 实现 流程 如 下 


所 示 。 


(1) 定义 系统 中 需要 的 常量 ， 并 分 别 设置 常量 的 初始 值 ， 具 体 实现 代码 如 下 所 示 。 
public class SoundRecorder extends Activity implements Button.OnClickListener, 


Recorder.OnStateChangedListener { 
private static final String TAG = "SoundRecorder"; 
private static final String RECORDER STATE KEY = "recorder state"; 
private static final Sting SAMPLE INTERRUPTED KEY - "sample interrupted"; 
private static final String MAX FILE SIZE KEY = "max file size"; 
private static final String AUDIO 3GPP = "audio/3gpp"; 
private static final String AUDIO AMR - "audio/amr"; 
private static final String AUDIO ANY - "audio/*"; 
private static final Sting ANY ANY = "*/*"; 
private static final String FILE EXTENSION АМАК = ".amr"; 
private static final String FILE EXTENSION 3GPP = ".39рр"; 
public static final int BITRATE AMR = 2 * 1024 * 8; // bits/sec 
public static final int BITRATE 3GPP = 20 * 1024 * 8; // bits/sec 
private static final int SEEK BAR MAX - 10000; 
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private static final long WHEEL_SPEED_NORMAL = 1800; 
private static final long WHEEL_SPEED FAST = 300; 


private static final long WHEEL SPEED SUPER FAST = 100; 


private static final long SMALL_WHEEL_SPEED_NORMAL = 900; 
private static final long SMALL_WHEEL_SPEED_FAST = 200; 
private static final long SMALL WHEEL SPEED SUPER FAST = 200; 
private String mRequestedType = AUDIO_ANY; 
private boolean mCanRequestChanged = false; 
private Recorder mRecorder; 
private RecorderReceiver mReceiver; 
private boolean mSamplelnterrupted = false; 
private boolean mShowFinishButton = false; 
private String mErrorUiMessage = null; // Some error messages are displayed 
II in the UI, not a dialog. This 
// happens when a recording 
ll is interrupted for some reason. 
private long mMaxFileSize = -1; // can be specified in the intent 
private RemainingTimeCalculator mRemainingTimeCalculator; 
private String mTimerFormat; 
private SoundPool mSoundPool; 
private int mPlaySound; 
private int mPauseSound; 
private HashSet<String> mSavedRecord; 
private long mLastClickTime; 
private int mLastButtonld; 
private final Handler mHandler = new Handler(); 
private Runnable mUpdateTimer = new Runnable() ( 
public void run() { 
if (ImStopUiUpdate) ( 
updateTimerView(); 
} 
} 
Шш 
(2) 在 函数 run() 中 调用 函数 updateSeekBar() 更 新 进度 条 的 值 ， 具 体 实现 代码 如 下 所 示 。 
private Runnable mUpdateSeekBar = new Runnable() { 
@Override 
public void run() { 
if (ImStopUiUpdate) { 
updateSeekBar(); 


} 
} 
y: 
СЗ) 根据 当前 状态 来 重 置 底部 按钮 的 状态 ， 例 如 在 播放 录音 时 ， 底 部 中 间 按 钮 变 为 停止 键 ， 具 体 
实现 代码 如 下 所 示 。 
@Override 
protected void onNewintent(Intent intent) { 
super.onNewlntent(intent); 
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boolean preShowFinishButton = mShowFinishButton; 
initInternalState(intent); 


if (mShowFinishButton || preShowFinishButton != mShowFinishButton) { 


} 


// 重 置 状 态 ， 如 果 它 是 一 记录 请 求 或 状态 改变 
mRecorder.reset(); 
resetFileNameEditText(); 


private void initlnternalState(Intent i) { 
mRequestedType = AUDIO_ANY; 
mShowFinishButton = false; 
if (i != null) { 


} 


String s = i.getType(); 
if (AUDIO_AMR.equals(s) || AUDIO 3GPP.equals(s) || AUDIO ANY.equals(s) 
|| ANY ANY.equals(s)) ( 
mRequestedType = s; 
mShowFinishButton = true; 
} else if (s != null) { 
II we only support amr and 3gpp formats right now 
setResult(RESULT CANCELED); 
finish(); 
return; 


} 


final String EXTRA MAX BYTES = android.provider.MediaStore.Audio.Media.EXTRA_MAX_BYTES; 
mMaxFileSize = i.getLongExtra(EXTRA MAX BYTES, -1); 


if (AUDIO ANY.equals(mRequestedType)) { 


mRequestedType = SoundRecorderPreferenceActivity.getRecordType(this); 


} else if (ANY ANY.equals(mRequestedType)) { 


} 
} 


mRequestedType = AUDIO_3GPP; 


(4) 根据 系统 设置 显示 当前 的 状态 信息 , 并 且 可 以 保存 当前 的 状态 信息 , 具体 实现 代码 如 下 所 示 。 
@Override 
public void onConfigurationChanged(Configuration newConfig) { 

super.onConfigurationChanged(newConfig); 


setContentView(R.layout.main); 


initResourceRefs(); 
updateUi(false); 

} 

@Override 


protected void onSavelnstanceState(Bundle outState) { 
super.onSavelnstanceState(outState); 


} 
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if (mRecorder.sampleLength() == 0) 
return; 


Bundle recorderState = new Bundle(); 


if (mRecorder.state() != Recorder.RECORDING_STATE) { 
mRecorder.saveState(recorderState); 

} 

recorderState.putBoolean(SAMPLE_INTERRUPTED_KEY, mSamplelnterrupted); 

recorderState.putLong(MAX FILE SIZE KEY, mMaxFileSize); 


outState.putBundle(RECORDER STATE KEY, recorderState); 


private void initResourceRefs() ( 


mNewButton = (ImageButton) findViewByld(R.id.newButton); 
mFinishButton = (ImageButton) findViewByld(R.id.finishButton); 
mRecordButton = (ImageButton) findViewByld(R.id.recordButton); 
mStopButton = (ImageButton) findViewByld(R.id.stopButton); 
mPlayButton = (ImageButton) findViewByld(R.id.playButton); 
mPauseButton = (ImageButton) findViewByld(R.id.pauseButton); 
mDeleteButton = (ImageButton) findViewByld(R.id.deleteButton); 
mNewButton.setOnClickListener(this); 
mFinishButton.setOnClickListener(this); 
mRecordButton.setOnClickListener(this); 
mStopButton.setOnClickListener(this); 
mPlayButton.setOnClickListener(this); 
mPauseButton.setOnClickListener(this); 
mDeleteButton.setOnClickListener(this); 


mWheelLeft = (WheellmageView) findViewByld(R.id.wheel_left); 

mWheelRight = (WheellmageView) findViewByld(R.id.wheel_right); 
mSmallWheelLeft = (WheellmageView) findViewByld(R.id.wheel small left); 
mSmallWheelRight = (WheellmageView) findViewByld(R.id.wheel small right); 
mFileNameEditText = (RecordNameEditText) find ViewByld(R.id.file name); 


resetFileNameEditText(); 
mFileNameEditText.setNameChangeListener(new RecordNameEditText.OnNameChangeListener() { 
@Override 
public void onNameChanged(String name) { 
if ({TextUtils.isEmpty(name)) { 
mRecorder.renameSampleFile(name); 
} 
} 
ys 


mTimerLayout = (LinearLayout) findViewByld(R.id.time calculator); 
mVUMeterLayout = (LinearLayout) findViewByld(R.id.vumeter_layout); 
mSeekBarLayout = (LinearLayout) findViewByld(R.id.play_seek_bar_layout); 
mStartTime = (TextView) findViewByld(R.id.starttime); 


(5) 每 当 重新 打开 用 户 界面 时 ， 必 须 重新 初始 化 UI 控件 和 视图 资源 ， 具 体 实现 代码 如 下 所 示 。 
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mTotalTime = (TextView) find ViewByld(R.iid.totaltime); 

mPlaySeekBar = (SeekBar) find ViewByld(R.id.play seek bar); 
mPlaySeekBar.setMax(SEEK BAR MAX); 
mPlaySeekBar.setOnSeekBarChangeListener(mSeekBarChangeListener); 


mTimerFormat = getResources().getString(R.string.timer format); 


if (mShowFinishButton) { 
mNewButton.setVisibility(View. GONE); 
mFinishButton.setVisibility(View. VISIBLE); 
mNewButton 7 mFinishButton; // use mNewButon variable for left 
11 button in the control panel 


} 


mSoundPool = new SoundPool(5, AudioManager.STREAM_SYSTEM, 5); 
mPlaySound = mSoundPool.load("/system/media/audio/ui/SoundRecorderPlay.ogg", 1); 
mPauseSound = mSoundPool.load("/system/media/audio/ui/SoundRecorderPause.ogg", 1); 


mLastClickTime = 0; 
mLastButtonld = 0; 
} 
(6) 重新 设置 EditText 控件 中 显示 的 文件 名 ， 有 具体 实现 代码 如 下 所 示 。 
private void resetFileNameEditText() { 
String extension = ""; 
if (AUDIO AMR.equals(mRequestedType)) { 
extension = FILE_EXTENSION_AMR; 
} else if (AUDIO_3GPP.equals(mRequestedType)) { 
extension = FILE EXTENSION 3GPP; 


} 
mFileNameEditText.initFileName(mRecorder.getRecordDir(), extension, mShowFinishButton); 

} 

CD 分 别 实现 开始 录音 、 停 止 录 音 、 播 放 录 音 、 向 前 动画 、 向 后 动画 和 停止 动画 效果 ， 有 具体 实现 
代码 如 下 所 示 。 

private void startRecordPlayingAnimation(){ 
mWheelLeft.startAnimation(WHEEL_SPEED_NORMAL, true); 
mWheelRight.startAnimation(WHEEL_SPEED_NORMAL, true); 
mSmallWheelLeft.startAnimation(SMALL_WHEEL_SPEED_NORMAL, true); 
mSmallWheelRight.startAnimation(SMALL_WHEEL_SPEED_NORMAL, true); 

} 


private void stopRecordPlayingAnimation() { 
stopAnimation(); 
startRecordPlayingDoneAnimation(); 

} 


private void startRecordPlayingDoneAnimation() { 
mWheelLeft.startAnimation(WHEEL_SPEED_SUPER_FAST, false, 4); 
mWheelRight.startAnimation(WHEEL SPEED SUPER FAST, false, 4); 
mSmallWheelLeft.startAnimation(SMALL_WHEEL_SPEED_SUPER_FAST, false, 2); 
mSmallWheelRight.startAnimation(SMALL_WHEEL_SPEED_SUPER_FAST, false, 2); 
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} 


private void startForwardAnimation() { 
mWheelLeft.startAnimation(WHEEL_SPEED_FAST, true); 
mWheelRight.startAnimation(WHEEL SPEED FAST, true); 
mSmallWheelLeft.startAnimation(SMALL WHEEL SPEED FAST, true); 
mSmallWheelRight.startAnimation(SMALL WHEEL SPEED FAST, true); 
) 


private void startBackwardAnimation() ( 
mWheelLleft.startAnimation( WHEEL SPEED FAST, false); 
mWheelRight.startAnimation( WHEEL SPEED FAST, false); 
mSmallWheelLeft.startAnimation(SMALL WHEEL SPEED FAST, false); 
mSmallWheelRight.startAnimation(SMALL WHEEL SPEED FAST, false); 


) 

private void stopAnimation() ( 
mWheelLeft.stopAnimation(); 
mWheelRight.stopAnimation(); 


mSmallWheelLeft.stopAnimation(); 
mSmallWheelRight.stopAnimation(); 

) 

C80 为 了 确保 不 会 录 上 在 后 台 播 放 的 音乐 , 调用 MediaPlaybackService 暂停 后 台 播 放 的 音频 文件 ， 
具体 实现 代码 如 下 所 示 。 

private void stopAudioPlayback() { 
11 Shamelessly copied from MediaPlaybackService java, which 
II should be public, but isn't. 
Intent i = new Intent("com.android.music.musicservicecommand"); 
i.putExtra("command", "pause"); 


sendBroadcast(i); 
) 
(9) 监听 用 户 单 击 底部 按钮 操作 ， 根 据 用 户 单 击 的 按钮 执行 对 应 的 事件 处 理 程序 ， 例 如 : 
public void onClick(View button) { 
if (System.currentTimeMillis() - mLastClickTime < 300) { 
/ in order to avoid user click bottom too quickly 
return; 


} 


if (Ibutton.isEnabled()) 
return; 


if (button.getld() == mLastButtonld && button.getld() != R.id.newButton) { 


// 需 要 避免 开展 重复 的 动作 
return; 
} 
if (button.getld() == R.id.stopButton && System.currentTimeMillis() - mLastClickTime < 1500) { 
/系统 崩溃 时 停止 录音 
return; 
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} 


mLastClickTime = System.currentTimeMillis(); 
mLastButtonld = button.getld(); 


switch (button.getld()) { 
case R.id.newButton: 
mFileNameEditText.clearFocus(); 
saveSample(); 
mRecorder.reset(); 
resetFileNameEditText(); 
break; 
case R.id.recordButton: 
showOverwriteConfirmDialoglfConflicts(); 
break; 
case R.id.stopButton: 
mRecorder.stop(); 
break; 
case R.id.playButton: 
mRecorder.startPlayback(mRecorder.playProgress()); 
break; 
case R.id.pauseButton: 
mRecorder.pausePlayback(); 
break; 
case R.id.finishButton: 
mRecorder.stop(); 
saveSample(); 
finish(); 
break; 
case R.id.deleteButton: 
showDeleteConfirmDialog(); 
break; 
} 
} 
(10) 单 击 录音 按钮 时 通过 函数 startRecording() 实 现 录音 功能 ， 具 体 实现 代码 如 下 所 示 。 
private void startRecording() { 
mRemainingTimeCalculator.reset(); 
if (IEnvironment.getExternalStorageState().equals(Environment. MEDIA MOUNTED)) { 
mSamplelnterrupted = true; 
mErrorUiMessage = getResources().getString(R.string.insert sd card); 
updateUi(false); 
} else if (imRemainingTimeCalculator.diskSpaceAvailable()) { 
mSamplelnterrupted = true; 
mErrorUiMessage = getResources().getString(R.string.storage is full); 
updateUi(false); 
) else ( 
stopAudioPlayback(); 


boolean isHighQuality = SoundRecorderPreferenceActivity.isHighQuality(this); 
if (AUDIO_AMR.equals(mRequestedType)) { 
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mRemainingTimeCalculator.setBitRate(BITRATE_AMR); 

int outputfileformat = isHighQuality ? MediaRecorder.OutputFormat.AMR WB 
: MediaRecorder.OutputFormat.AMR NB; 

mRecorder.startRecording(outputfileformat, mFileNameEditText.getText().toString(), 
FILE EXTENSION AMR, isHighQuality, mMaxFileSize); 

} else if (AUDIO 3GPP.equals(mRequestedType)) ( 

1] HACKME: for HD2, there is an issue with high quality Зарр 

ll use low quality instead 

if (Build. MODEL.equals("HTC HD2")) ( 

isHighQuality = false; 
} 


mRemainingTimeCalculator.setBitRate(BITRATE 3GPP); 
mRecorder.startRecording(MediaRecorder.OutputFormat. THREE GPP, mFileNameEditText 
.getText().toString(), FILE EXTENSION 3GPP, isHighQuality, mMaxFileSize); 
) else { 
throw new lllegalArgumentException("Invalid output file type requested"); 
) 


if (mMaxFileSize != -1) ( 
mRemainingTimeCalculator.setFileSizeLimit(mRecorder.sampleFile(), mMaxFileSize); 


} 
} 
} 
(11) 通过 函数 onResume() 实 现 重 置 按钮 的 处 理 功能 ， 有 具体 实现 代码 如 下 所 示 。 
@Override 
protected void onResume() { 
super.onResume(); 


String type = SoundRecorderPreferenceActivity.getRecordType(this); 
if (mCanRequestChanged && !TextUtils.equals(type, mRequestedType)) { 
saveSample(); 
mRecorder.reset(); 
mRequestedType = type; 
resetFileNameEditText(); 
} 
mCanRequestChanged = false; 


if (ImRecorder.syncStateWithService()) { 
mRecorder.reset(); 
resetFileNameEditText(); 

} 


if (mRecorder.state() == Recorder. RECORDING_STATE) { 
String preExtension = AUDIO_AMR.equals(mRequestedType) ? FILE_EXTENSION_AMR 
: FILE_EXTENSION_3GPP; 

if (ImRecorder.sampleFile().getName().endsWith(preExtension)) ( 
11 the extension is changed need to stop current recording 
mRecorder.reset(); 
resetFileNameEditText(); 

) else { 
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II restore state 

if (ImShowFinishButton) ( 
String fileName = mRecorder.sampleFile().getName().replace(preExtension, ""); 
mFileNameEditText.setText(fileName); 

} 


if (AUDIO_AMR.equals(mRequestedType)) { 
mRemainingTimeCalculator.setBitRate(BITRATE_AMR); 
} else if (AUDIO 3GPP.equals(mRequestedType)) ( 
mRemainingTimeCalculator.setBitRate(BITRATE 3GPP); 
} 
} 
) else { 
File file = mRecorder.sampleFile(); 
if (file != null && !file.exists()) ( 
mRecorder.reset(); 
resetFileNameEditText(); 


} 


IntentFilter filter = new IntentFilter(); 
filter.addAction(RecorderService.RECORDER SERVICE BROADCAST NAME); 
registerReceiver(mReceiver, filter); 


mStopUiUpdate = false; 
updateUi(true); 


if (RecorderService.isRecording()) { 
Intent intent = new Intent(this, RecorderService.class); 
intent. putExtra(RecorderService.ACTION NAME, 
RecorderService.ACTION_DISABLE_MONITOR_REMAIN_TIME); 
startService(intent); 
} 
} 
(12) 通过 函数 onPause() 实 现 暂停 按钮 的 事件 处 理 功能 ， 有 具体 实现 代码 如 下 所 示 。 
@Override 
protected void onPause() { 
if (mRecorder.state() != Recorder.RECORDING_STATE || mShowFinishButton 
|| mMaxFileSize != -1) { 
mRecorder.stop(); 
saveSample(); 
mFileNameEditText.clearFocus(); 
((NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE)) 
.cancel(RecorderService.NOTIFICATION ID); 
) 


if (mReceiver != null) { 
unregisterReceiver(mReceiver); 


} 
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mCanRequestChanged = true; 
mStopUiUpdate = true; 
stopAnimation(); 


if (RecorderService.isRecording()) { 
Intent intent = new Intent(this, RecorderService.class); 
intent.putExtra(RecorderService.ACTION NAME, 
RecorderService. ACTION ENABLE MONITOR REMAIN TIME); 


startService(intent); 
} 
super.onPause(); 
} 
@Override 
protected void onStop() { 
if (mShowFinishButton) { 
finish(); 
} 
super.onStop(); 
} 


(13) 如 果 录 音 完毕 ,通过 函数 saveSample() 实 现 单 击 停止 录音 按钮 的 事件 处 理 程序 ， 保 存 当前 的 
音频 文件 到 媒体 库 ， 具 体 实现 代码 如 下 所 示 。 
private void saveSample() { 

if (mRecorder.sampleLength() == 0) 
return; 

if (ImSavedRecord.contains(mRecorder.sampleFile().getAbsolutePath())) ( 
Uri uri = null; 
try( 

uri = this.addToMediaDB(mRecorder.sampleFile()); 

} catch (UnsupportedOperationException ex) ( // Database 


II manipulation 
// failure 
return; 

) 

if (uri == null) ( 
return; 

) 


mSavedRecord.add(mRecorder.sampleFile().getAbsolutePath()); 
setResult(RESULT OK, new Intent().setData(uri)); 
) 
) 
C14) 通过 函数 showDeleteConfirmDialog() 实 现 单 击 删除 按钮 的 事件 处 理 程序 , 弹出 一 个 确认 删除 
对 话 框 ， 具 体 实现 代码 如 下 所 示 。 
private void showDeleteConfirmDialog() { 
AlertDialog. Builder dialogBuilder = new AlertDialog.Builder(this); 
dialogBuilder.setlcon(android.R.drawable.ic dialog alert); 
dialogBuilder.setTitle(R.string.delete dialog title); 
dialogBuilder.setPositiveButton(android.R.string.ok, new DialogInterface.OnClickListener() { 
@Override 
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public void onClick(DialogInterface dialog, int which) ( 
mRecorder.delete(); 
} 
}); 
dialogBuilder.setNegativeButton(android.R.string.cancel, 
new DialogInterface.OnClickListener() { 
@Override 
public void onClick(DialogInterface dialog, int which) í 
mLastButtonld = 0; 
} 
р; 
dialogBuilder.show(); 
} 


u 


(15) 函数 showOverwriteConfirmDialogIfConflicts0) 的 功能 是 ， 在 保存 录音 文件 时 如 果 在 媒体 库 9 
已 经 存在 同名 文件 则 会 弹出 一 个 提示 对 话 框 ， 具 体 实现 代码 如 下 所 示 。 
private void showOverwriteConfirmDialoglfConflicts() ( 
String fileName = mFileNameEditText.getText().toString() 
+ (AUDIO AMR.equals(mRequestedType) ? FILE EXTENSION AMR: FILE EXTENSION 
3GPP); 


if (mRecorder.isRecordExisted(fileName) && !mShowFinishButton) ( 
AlertDialog. Builder dialogBuilder = new AlertDialog.Builder(this); 
dialogBuilder.setlcon(android.R.drawable.ic dialog alert); 
dialogBuilder.setTitle(getString(R.string.overwrite dialog title, fleName)); 
dialogBuilder.setPositiveButton(android.R.string.ok, 
new DialogInterface.OnClickListener() ( 
@Override 
public void onClick(DialogInterface dialog, int which) { 
startRecording(); 
} 
ys 
dialogBuilder.setNegativeButton(android.R.string.cancel, 
new Dialoginterface.OnClickListener() { 
@Override 
public void onClick(DialogInterface dialog, int which) { 
mLastButtonld = 0; 


} 
» 
dialogBuilder.show(); 
) else ( 
startRecording(); 
} 


} 
(16) 通过 函数 addToPlaylist() 将 录制 音频 添加 到 播放 列表 中 ， 具 体 实现 代码 如 下 所 示 。 
private void addToPlaylist(ContentResolver resolver, int audiold, long playlistld) { 
String[ ] cols = new String[ ] ( 
"count(*)" 
іЯ 
Uri uri = MediaStore.Audio.Playlists.Members.getContentUri("external", playlistld); 
Cursor cur = resolver.query(uri, cols, null, null, null); 


@ 
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cur.moveToFirst(); 
final int base = cur.getlnt(0); 
cur.close(); 
ContentValues values = new ContentValues(); 
values. put(MediaStore.Audio.Playlists. Members.PLAY ORDER, Integer.valueOf(base + audiold)); 
values.put(MediaStore.Audio.Playlists. Members.AUDIO D, audiold); 
resolver.insert(uri, values); 
) 
(17) 通过 函数 getPlaylistId() 从 表 audio playlists 中 获取 默认 播放 列表 的 ID， 有 具体 实现 代码 如 下 
所 示 。 
private int getPlaylistld(Resources res){ 
Uri uri = MediaStore.Audio.Playlists.getContentUri("external"); 
final String[ ] ids = new String[ ] { 
MediaStore.Audio.Playlists. ID 
y: 
final String where = MediaStore.Audio.Playlists.NAME + "=?"; 
final String[ ] args = new String[]{ 
res.getString(R.string.audio db playlist name) 
In 
Cursor cursor = query (uri, ids, where, args, null); 
if (cursor == null) ( 
Log.v(TAG, "query returns null"); 
} 
int id = -1; 
if (cursor != null) { 
cursor.moveToFirst(); 
if (Icursor.isAfterLast()) ( 
id = cursor.getint(0); 
) 
cursor.close(); 
) 
return id; 
) 
C18) 通过 函数 createPlaylist() 创 建 一 个 播放 列表 ， 前 提 是 系统 中 没有 同名 列表 存在 ， 具 体 实现 代 
码 如 下 所 示 。 
private Uri createPlaylist(Resources res, ContentResolver resolver) { 
ContentValues cv = new ContentValues(); 
cv.put(MediaStore.Audio.Playlists. NAME, res.getString(R.string.audio_db_playlist_name)); 
Uri uri = resolver.insert(MediaStore.Audio.Playlists.getContentUri("external"), cv); 
if (uri == null) ( 
new AlertDialog.Builder(this).setTitle(R.string.app name) 
.setMessage(R.string.error mediadb new record) 
.setPositiveButton(R.string.button ok, null).setCancelable(false).show(); 
) 
return uri; 
} 
(19) 函数 getTimerImage() 的 功能 是 根据 当前 时 间 调 月 
果 ， 具 体 实现 代码 如 下 所 示 。 
private ImageView getTimerlmage(char number) { 


对 应 的 图 片 ， 以 实现 图 形 化 的 数字 时 钟 效 
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ImageView image = new ImageView(this); 
LayoutParams Ip = new LayoutParams(LayoutParams.WRAP_CONTENT, LayoutParams.WRAP_CONTENT); 
if (number != ':') { 
image.setBackgroundResource(R.drawable.background_number); 
} 
switch (number) { 
case '0': 
image.setlmageResource(R.drawable.number 0); 
break; 
case '1': 
image.setlmageResource(R.drawable.number 1); 
break; 
case 2" 
image.setlmageResource(R.drawable.number 2); 
break; 
case '3': 
image.setlmageResource(R.drawable.number 3); 
break; 
case '4': 
image.setlmageResource(R.drawable.number 4); 
break; 
case '5': 
image.setlmageResource(R.drawable.number 5); 
break; 
case '6': 
image.setlmageResource(R.drawable.number 6); 
break; 
case '7': 
image.setlmageResource(R.drawable.number 7); 
break; 
case '8': 
image.setlmageResource(R.drawable.number 8); 
break; 
case '9': 
image.setlmageResource(R.drawable.number 9); 
break; 
case ':': 
image.setlmageResource(R.drawable.colon); 
break; 
} 
image.setLayoutParams(Ip); 
return image; 
} 
(20) 更 新 MM: SS 格式 的 计时 器 的 时 间 ， 如 果 正 在 播放 音频 ， 也 随 之 更 新 进度 条 的 时 间 ， 具 体 
实现 代码 如 下 所 示 。 
private void updateTimerView() { 
int state = mRecorder.state(); 
boolean ongoing = state == Recorder.RECORDING STATE || state == Recorder.PLAYING STATE; 


long time = mRecorder.progress(); 
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String timeStr = String.format(mTimerFormat, time / 60, time % 60); 

mTimerLayout.removeAllViews(); 

for (int i = 0; i < timeStr.length(); i++) { 
mTimerLayout.addView(getTimerlmage(timeStr.charAt(i))); 

} 


if (state == Recorder.RECORDING_STATE) { 


updateTimeRemaining(); 
} 
if (ongoing) { 
mHandler.postDelayed(mUpdateTimer, 500); 
} 


} 


private void setTimerView(float progress) { 
long time = (long) (progress * mRecorder.sampleLength()); 
String timeStr = String.format(mTimerFormat, time / 60, time % 60); 
mTimerLayout.removeAllViews(); 
for (int i = 0; i < timeStr.length(); i++) ( 
mTimerLayout.addView(getTimerlmage(timeStr.charAt(i))); 
} 
} 


private void updateSeekBar() ( 
if (mRecorder.state() == Recorder.PLAYING STATE) { 
mPlaySeekBar.setProgress((int) (SEEK BAR. MAX * mRecorder.playProgress())); 
mHandler.postDelayed(mUpdateSeekBar, 10); 
} 
} 
(21) 函数 updateTimeRemaining() 的 功能 比较 人 性 化 ， 此 函数 在 录音 状态 下 被 调用 ， 用 于 显示 还 
可 以 录制 多 少时 间 。 如 果 还 可 以 录制 5 分 钟 , 则 在 UI 中 显示 一 个 倒计时 时 钟 , 如 果 已 经 用 完 这 5 分 钟 ， 
则 立即 停止 录制 ， 具 体 实现 代码 如 下 所 示 。 
private void updateTimeRemaining() { 
long t = mRemainingTimeCalculator.timeRemaining(); 


if (t <= 0){ 
mSamplelnterrupted = true; 


int limit = mRemainingTimeCalculator.currentLowerLimit(); 
switch (limit) ( 
case RemainingTimeCalculator.DISK SPACE LIMIT: 
mErrorUiMessage = getResources().getString(R.string.storage_is_full); 
break; 
case RemainingTimeCalculator.FILE_SIZE_LIMIT: 
mErrorUiMessage = getResources().getString(R.string.max_length_reached); 
break; 
default: 
mErrorUiMessage = null; 
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} 


break; 


mRecorder.stop(); 


(22) 根据 用 户 的 操作 和 当前 的 状态 更 新 UI 界面 视图 ， 有 具体 实现 代码 如 下 所 示 。 
private void updateUi(boolean skipRewindAnimation) { 


e 


switch (mRecorder.state()) ( 
case Recorder.IDLE STATE: 
mLastButtonld = 0; 
case Recorder.PLAYING PAUSED STATE: 
if (mRecorder.sampleLength() == 0) ( 


mNewButton.setEnabled(true); 
mNewButton.setVisibility(View. VISIBLE); 
mRecordButton.setVisibility(View.VISIBLE); 
mStopButton.setVisibility(View.GONE); 
mPlayButton.setVisibility(View.GONE); 
mPauseButton.setVisibility(View.GONE); 
mDeleteButton.setEnabled(false); 
mRecordButton.requestFocus(); 


mVUMeterLayout.setVisibility(View.VISIBLE); 
mSeekBarLayout.setVisibility(View.GONE); 


) else { 


mNewButton.setEnabled(true); 
mNewButton.setVisibility(View.VISIBLE); 
mRecordButton.setVisibility(View.GONE); 
mStopButton.setVisibility(View.GONE); 
mPlayButton.setVisibility(View. VISIBLE); 
mPauseButton.setVisibility(View.GONE); 
mDeleteButton.setEnabled(true); 
mPauseButton.requestFocus(); 


mVUMeterLayout.setVisibility(View.GONE); 

mSeekBarLayout.setVisibility(View. VISIBLE); 

mStartTime.setText(String.format(mTimerFormat, 0, 0)); 

mTotalTime.setText(String.format(mTimerFormat, mRecorder.sampleLength() / 60, 
mRecorder.sampleLength() % 60)); 


mFileNameEditText.setEnabled(true); 
mFileNameEditText.clearFocus(); 


if (mRecorder.sampleLength() > 0) { 


if (mRecorder.state() == Recorder.PLAYING PAUSED STATE) { 
stopAnimation(); 
if (SoundRecorderPreferenceActivity.isEnabledSoundEffect(this)) { 
mSoundPool.play(mPauseSound, 1.0f, 1.0f, 0, 0, 1); 
} 


) else { 
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mPlaySeekBar.setProgress(0); 
if (IskipRewindAnimation) { 
stopRecordPlayingAnimation(); 
}else { 
stopAnimation(); 
} 
} 
) else { 
stopAnimation(); 


} 


II we allow only one toast at one time 
if (mSamplelnterrupted && mErrorUiMessage == null) { 

Toast.makeText(this, R.string.recording_stopped, Toast.LENGTH_SHORT).show(); 
} 


if (mErrorUiMessage != null) { 
Toast.makeText(this, mErrorUiMessage, Toast.LENGTH_SHORT).show(); 
} 


break; 

case Recorder.RECORDING STATE: 
mNewButton.setEnabled(false); 
mNewButton.setVisibility(View. VISIBLE); 
mRecordButton.setVisibility (View.GONE); 
mStopButton.setVisibility(View.VISIBLE); 
mPlayButton.setVisibility(View.GONE); 
mPauseButton.setVisibility(View.GONE); 
mDeleteButton.setEnabled(false); 
mStopButton.requestFocus(); 


mVUMeterLayout.setVisibility(View.VISIBLE); 
mSeekBarLayout.setVisibility(View.GONE); 


mFileNameEditText.setEnabled(false); 


startRecordPlayingAnimation(); 
mPreviousVUMax = 0; 
break; 


case Recorder.PLAYING STATE: 
mNewButton.setEnabled(false); 
mNewButton.setVisibility(View. VISIBLE); 
mRecordButton.setVisibility(View.GONE); 
mStopButton.setVisibility(View.GONE); 
mPlayButton.setVisibility(View.GONE); 
mPauseButton.setVisibility(View. VISIBLE); 
mDeleteButton.setEnabled(false); 
mPauseButton.requestFocus(); 


mVUMeterLayout.setVisibility(View.GONE); 
mSeekBarLayout.setVisibility(View. VISIBLE); 
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mFileNameEditText.setEnabled(false); 


if (SoundRecorderPreferenceActivity isEnabledSoundEffect(this)) { 
mSoundPool.play(mPlaySound, 1.0f, 1.0f, 0, 0, 1); 

) 

startRecordPlayingAnimation(); 

break; 


) 


updateTimerView(); 
updateSeekBar(); 
updateVUMeterView(); 
) 
(23) “4 MediaPlayer 出 错时 会 调用 onError(0) 函 数 ， 有 具体 实现 代码 如 下 所 示 。 
public void onError(int error) { 
Resources res = getResources(); 
String message = null; 
switch (error) { 
case Recorder.STORAGE_ACCESS_ERROR: 
message = res.getString(R.string.error_sdcard_access); 
break; 
case Recorder.IN CALL RECORD ERROR: 
II TODO: update error message to reflect that the recording 
ll could not be 
II performed during a call. 
case Recorder.INTERNAL ERROR: 
message - res.getString(R.string.error app internal); 
break; 
} 
if (message != null) { 
new AlertDialog.Builder(this).setTitle(R.string.app_name).setMessage(message) 
.setPositiveButton(R.string.button ok, null).setCancelable(false).show(); 
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当 单 击 设备 的 MENU 键 时 会 弹出 一 个 操作 选项 框 ， 如 图 13-5 所 示 。 
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13-5 ”操作 选项 框 
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当选 择 选 项 框 中 的 Open file explorer 选项 时 会 打开 文件 浏览 器 。 在 本 节 的 内 容 中 ， 将 详细 讲解 系 
统 设置 界面 的 具体 实现 流程 。 


13.3.1 事件 处 理 程序 


当 用 户 单 击 图 13-5 中 的 某 个 选项 时 , 会 调用 函数 onOptionsItemSelected() 来 监听 操作 ， 并 执行 对 应 


的 事件 处 理 程序 ， 具 体 实现 代码 如 下 所 示 。 
@Override 
public boolean onPrepareOptionsMenu(Menu menu) { 
menu.clear(); 
if (mRecorder.state() == Recorder.RECORDING STATE 
|| mRecorder.state() == Recorder.PLAYING STATE) { 
return false; 
) else { 
getMenulnflater().inflate(R.layout.view list menu, menu); 
return true; 


) 
) 
public boolean onOptionsltemSelected(Menultem item) { 
Intent intent; 
Switch (item.getltemld()) { 
case R.id.menu fm: 
saveSample(); 
intent = new Intent(); 
intent.addCategory(Intent. CATEGORY DEFAULT); 
intent.setData(Uri.parse("file://" + mRecorder.getRecordDir())); 
startActivity(intent); 
break; 
case R.id.menu_setting: 
intent = new Intent(this, SoundRecorderPreferenceActivity.class); 
startActivity(intent); 
break; 
default: 
break; 
} 
return true; 


} 
13.3.2 ”实现 程序 文件 


系统 设置 界面 的 布局 文件 是 preferences.xml， 具 体 实现 代码 如 下 所 示 。 
<PreferenceScreen 
xmins:android="http://schemas.android.com/apk/res/android"> 
<PreferenceCategory> 
<ListPreference 
android:key-"pref key record type" 
android:title-"(gstring/pref title record type" 
android:entries="@array/prefEntries_recordType" 
android:entryValues="@array/prefValues_recordType" 
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android:dialogTitle="@string/prefDialogTitle_recordType" 
android:defaultValue="@string/prefDefault_recordType" /> 
<CheckBoxPreference 
android:key-"pref key enable high quality" 
android:titlez"(gstring/pref title enable high quality" 
android:summary-"g)string/pref summary enable high quality" 
android:defaultValue="true" /> 
</PreferenceCategory> 
<PreferenceCategory> 
<CheckBoxPreference 
android:key-"pref key enable sound effect" 
android:title-"(gstring/pref title enable sound effect" 
android:summary="@string/pref_summary enable sound effect" 
android:defaultValue-"true" /> 
</PreferenceCategory> 
</PreferenceScreen> 
对 应 的 程序 文件 是 SoundRecorderPreferenceActivityjava， 用 于 加 载 显示 UI 布局 文件 中 的 控件 ， 并 监 
听 用 户 的 操作 选项 对 系统 进行 设置 。 文 件 SoundRecorderPreferenceActivity.java 的 具体 实现 代码 如 下 所 示 。 
public class SoundRecorderPreferenceActivity extends PreferenceActivity { 
private static final Sting RECORD TYPE = "pref key record type"; 
private static final Sting ENABLE HIGH QUALITY = "pref key enable high quality"; 
private static final Sting ENABLE SOUND EFFECT = "pref key enable sound effect"; 
@Override 
protected void onCreate(Bundle icicle) { 
super.onCreate(icicle); 
addPreferencesFromResource(R.xml.preferences); 
} 
public static String getRecordType(Context context) { 
SharedPreferences settings = PreferenceManager.getDefaultSharedPreferences(context); 
return settings.getString(RECORD ТҮРЕ, context.getString(R.string.prefDefault recordType)); 
} 
public static boolean isHighQuality(Context context) { 
SharedPreferences settings = PreferenceManager.getDefaultSharedPreferences(context); 
return settings.getBoolean(ENABLE HIGH QUALITY, true); 
} 
public static boolean isEnabledSoundEffect(Context context) { 
SharedPreferences settings = PreferenceManager.getDefaultSharedPreferences(context); 
return settings.getBoolean(ENABLE_SOUND_EFFECT, true); 
} 
} 


系统 设置 界面 的 执行 效果 如 图 13-6 所 示 。 


图 13-6 系统 设置 界面 
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知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 13 章 \ 修 改 文本 框 的 文本 .avi 
在 系统 主 界面 的 EditText 中 ， 可 以 设置 修改 录音 文件 的 名 字 ， 此 功能 是 通过 文件 RecordName 
EditText.java 实现 的 ， 具 体 实现 代码 如 下 所 示 。 
public class RecordNameEditText extends EditText { 
private Context mContext; 
private InputMethodManager mlnputMethodManager; 
private OnNameChangeListener mNameChangeListener; 
private String mDir; 
private String mExtension; 
private String mOriginalName; 
public interface OnNameChangeListener { 
void onNameChanged(String name); 
} 
public RecordNameEditText(Context context) { 
super(context, null); 
mContext = context; 
minputMethodManager = (InputMethodManager) context 
.getSystemService(Context.INPUT METHOD SERVICE); 
mNameChangeListener = null; 
) 
public RecordNameEditText(Context context, AttributeSet attrs) ( 
super(context, attrs); 
mContext = context; 
minputMethodManager = (InputMethodManager) context 
.getSystemService(Context.I:NPUT METHOD SERVICE); 
mNameChangeListener = null; 
} 
public RecordNameEditText(Context context, AttributeSet attrs, int defStyle) { 
super(context, attrs, defStyle); 
mContext = context; 
minputMethodManager = (InputMethodManager) context 
.getSystemService(Context.I:NPUT METHOD SERVICE); 
mNameChangeListener = null; 
} 
public void setNameChangeListener(OnNameChangeListener listener) { 
mNameChangeListener = listener; 


} 

public void initFileName(String dir, String extension, boolean englishOnly) { 
mDir = dir; 
mkExtension = extension; 
// 初 始 化 默认 名 字 


if (lenglishOnly) { 
setText(getProperFileName(mContext.getString(R.string.default_record_name))); 
}else{ 
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SimpleDateFormat dataFormat = new SimpleDateFormat("MMddHHmmss"); 
setText(getProperFileName("rec_" + dataFormat.format(Calendar.getInstance().getTime()))); 
} 
} 
private String getProperFileName(String name) { 
String uniqueName = name; 


if (isFileExisted(uniqueName)) { 
inti = 2; 
while (true) ( 
String temp = uniqueName + "(" + i + ")"; 
if (lisFileExisted(temp)) ( 
uniqueName = temp; 
break; 


i++; 


retum uniqueName; 
} 
private boolean isFileExisted(String name) { 
String fullName = mDir + "/" + name.trim() + mExtension; 
File file = new File(fullName); 
return file.exists(); 
} 
@Override 
public boolean onKeyUp(int keyCode, KeyEvent event) { 
switch (keyCode) { 
case KeyEvent.KEYCODE_ENTER: 
if (mNameChangeListener != null) { 
String name = getText().toString().trim(); 
if (ITextUtils.isEmpty(name)) { 
// 使 用 新 名 字 
setText(name); 
mNameChangeListener.onNameChanged(name); 
) else { 
// 使 用 原始 名 字 
setText(mOriginalName); 
} 
clearFocus(); 
// 隐 藏 键盘 
minputMethodManager. hideSoftInputFromWindow(getWindowToken(), 0); 
return true; 
} 
break; 
default: 
break; 
} 
return super.onKeyUp(keyCode, event); 
} 
@Override 
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protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) { 
super.onFocusChanged(focused, direction, previouslyFocusedRect); 
if (!focused && mNameChangeListener != null) { 
String name = getText().toString().trim(); 
if (!TextUtils.isEmpty(name)) { 


/使 用 新 名 字 
setText(name); 
mNameChangeListener.onNameChanged(name); 
) else { 
/使 用 原始 名 字 
setText(mOriginalName); 
} 
11 hide the keyboard 
minputMethodManager.hideSoftlnputFromWindow(getWindowToken(), 0); 
) else if (focused) ( 


mOriginalName = getText().toString(); 
} 


13.5 计算 剩余 时 间 


ШИ 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 13 章 \ 计 算 剩余 时 间 .avi 
在 系统 主 界面 中 会 显示 当前 存储 卡 的 容量 还 允许 录制 多 少时 间 。 如 果 还 可 以 录制 5 分 钟 ， 则 在 UI 
中 显示 一 个 倒计时 时 钟 ， 如 果 已 经 用 完 这 5 分 钟 ， 则 立即 停止 录制 。 计 算 剩余 时 间 的 核心 功能 是 通过 
文件 RemainingTimeCalculatorjava 实现 的 ， 具 体 实现 代码 如 下 所 示 。 
public class RemainingTimeCalculator { 
public static final int UNKNOWN_LIMIT = 0; 
public static final int FILE_SIZE_LIMIT = 1; 
public static final int DISK SPACE LIMIT = 2; 
private static final int EXTERNAL_STORAGE_BLOCK_THREADHOLD = 32; 
private int mCurrentLowerLimit = UNKNOWN LIMIT; 
private File mRecordingFile; 
private long mMaxBytes; 
private int mBytesPerSecond; 
private long mBlocksChangedTime; 
private long mLastBlocks; 
private long mFileSizeChangedTime; 
private long mLastFileSize; 
public RemainingTimeCalculator() { 
} 
p 
* 设置 文件 大 小 限制 
ot 
public void setFileSizeLimit(File file, long maxBytes) { 
mRecordingFile = file; 
mMaxBytes = maxBytes; 
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* 重 置 interpolation 


public void reset() { 


mCurrentLowerLimit = UNKNOWN_LIMIT; 
mBlocksChangedTime = -1; 
mFileSizeChangedTime = -1; 


* 返 回 的 时 间 以 秒 计 ) ， 我 们 可 以 继续 录制 


public long timeRemaining() { 


II Calculate how long we can record based on free disk space 
StatFs fs = null; 

long blocks = -1; 

long blockSize = -1; 

long now = System.currentTimeMillis(); 


fs = new StatFs(Environment.getExternalStorageDirectory().getAbsolutePath()); 
blocks = fs.getAvailableBlocks() - EXTERNAL_STORAGE_BLOCK_THREADHOLD; 
blockSize = fs.getBlockSize(); 
if (blocks < 0) { 

blocks = 0; 
} 


if (mBlocksChangedTime == -1 || blocks != mLastBlocks) { 
mBlocksChangedTime = now; 
mLastBlocks = blocks; 


} 
II at mBlocksChangedTime we had this much time 
long result = mLastBlocks * blockSize / mBytesPerSecond; 
// 现 在 我 们 有 这 么 多 的 时 间 
result -= (now - mBlocksChangedTime) / 1000; 
if (mRecordingFile == null) { 
mCurrentLowerLimit = DISK SPACE LIMIT; 
return result; 


) 
// 计 算 预 估 
mRecordingFile = new File(mRecordingFile.getAbsolutePath()); 
long fileSize = mRecordingFile.length(); 
if (mFileSizeChangedTime == -1 || fileSize != mLastFileSize) { 
mFileSizeChangedTime = now; 
mLastFileSize = fileSize; 
} 
long result2 = (mMaxBytes - fileSize) / mBytesPerSecond; 
result2 -= (now - mFileSizeChangedTime) / 1000; 
result2 -= 1; // just for safety 
mCurrentLowerLimit = result < result2 ? DISK SPACE LIMIT : FILE SIZE LIMIT; 
return Math.min(result, result2); 
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p 
* 指出 限制 
*l 
public int currentLowerLimit() { 
return mCurrentLowerLimit; 


p 
* 是 否 有 任何 一 点 的 尝试 开始 录制 
public boolean diskSpaceAvailable(){ 
StatFs fs = new StatFs(Environment.getExternalStorageDirectory().getAbsolutePath()); 
II keep one free block 
return fs.getAvailableBlocks() » EXTERNAL STORAGE BLOCK THREADHOLD; 
} 
p 
* i$ interpolation 的 比特 率 


* @param bitRate the bit rate to set in bits/sec. 
zi 
public void setBitRate(int bitRate) { 

mBytesPerSecond = bitRate / 8; 
} 


13.6 素材 修饰 


知识 点 讲解 :光盘 :视频 \ 知 识 点 第 13 章 \ 素 材 修饰 avi 
为 了 使 系统 中 的 UI 控件 以 完美 的 效果 展示 出 来 ，MIUI 团队 对 图 片 和 动画 实现 了 修饰 美化 。 其 中 
使 用 文件 SeamlessAnimation.java 实现 了 无 颖 动画 显示 效果 ， 有 具体 实现 代码 如 下 所 示 。 
public class SeamlessAnimation extends Animation { 
private float mFromDegrees; 
private float mToDegrees; 
private float mPivotX; 
private float mPivotY; 
private int mPivotXType; 
private float mPivotXValue; 
private int mPivotYType; 
private float mPivotY Value; 
private boolean mCancelled; 
private float mDegree; 
public SeamlessAnimation(float fromDegrees, float toDegrees, int pivotXType, float pivotXValue, 
int pivotYType, float pivotYValue) { 
mFromDegrees = fromDegrees; 
mToDegrees = toDegrees; 
mPivotXType = pivotXType; 
mPivotXValue = pivotXValue; 
mPivotY Type = pivotYType; 
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mPivotYValue = pivotYValue; 
mCancelled = false; 
mDegree = fromDegrees; 
} 
public void initialize(int width, int height, int parentWidth, int parentHeight) { 
super.initialize(width, height, parentWidth, parentHeight); 
mPivotX = resolveSize(mPivotXType, mPivotXValue, width, parentWidth); 
mPivotY = resolveSize(mPivotYType, mPivotYValue, height, parentHeight); 
} 
public float getDegree() { 
return mDegree; 
} 
@Override 
public void cancel() { 
super.cancel(); 
mCancelled = true; 
} 
@Override 
protected void applyTransformation(float interpolatedTime, Transformation t) { 
if (ImCancelled) ( 
mDegree = mFromDegrees + ((mToDegrees - mFromDegrees) * interpolatedTime); 


} 
t.getMatrix().setRotate(mDegree, mPivotX, mPivotY); 
} 
} 
通过 文件 WheellmageView.java 实现 了 磁带 轮子 图 片 和 无 颖 动画 效果 的 完美 融合 , 具体 实现 代码 如 
下 所 示 。 


public class WheellmageView extends ImageView { 
SeamlessAnimation mAnimation; 
public WheellmageView(Context context) { 
super(context); 
mAnimation = null; 
} 
public WheellmageView(Context context, AttributeSet attrs) { 
super(context, attrs); 
mAnimation = null; 
} 
public WheellmageView(Context context, AttributeSet attrs, int defStyle) { 
super(context, attrs, defStyle); 
mAnimation = null; 
} 
private void initAnimation(long duration, boolean isForward, int repeatCount) { 
LinearlInterpolator lir = new Linearlnterpolator(); 
float from; 
float to; 
if (isForward) ( 
from = (mAnimation == null || mAnimation.getRepeatCount() != Animation.INFINITE) ? 0.0f 
: mAnimation.getDegree(); 
to - from * 360.0f; 
} else ( 
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from = (mAnimation == null || mAnimation.getRepeatCount() != Animation.INFINITE) ? 360.0f 


: mAnimation.getDegree(); 
to = from - 360.0f; 
) 
if (isForward) { 
mAnimation = new SeamlessAnimation(from, to, Animation.RELATIVE TO SELF, 0.5f, 
Animation.RELATIVE_TO_SELF, 0.5f); 
) else { 
mAnimation = new SeamlessAnimation(from, to, Animation.RELATIVE TO SELF, 0.5f, 
Animation.RELATIVE_TO_SELF, 0.5f); 
} 
mAnimation.setDuration (duration); 


mAnimation.setRepeatMode(Animation.RESTART); 
mAnimation.setRepeatCount(repeatCount); 
mAnimation.setinterpolator(lir); 
} 
public void startAnimation(long duration, boolean isForward) { 
startAnimation(duration, isForward, Animation.INFINITE); 
} 
public void startAnimation(long duration, boolean isForward, int repeatCount) { 
initAnimation(duration, isForward, repeatCount); 
startAnimation(mAnimation); 
} 
public void stopAnimation() { 
if (mAnimation != null) { 
mAnimation.cancel(); 
mAnimation = null; 
clearAnimation(); 
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在 本 章 的 实例 项 目 中 ， 将 演示 在 Android 设备 中 开发 一 个 智能 楼 宇 灯光 控制 系统 的 方法 。 本 实例 
是 一 个 商业 项 目 ， 需 要 开发 人 员额 外 编写 驱动 程序 和 底层 蓝牙 控制 程序 。 在 本 章 的 内 容 中 ， 将 只 讲解 
Android 应 用 程序 的 实现 过 程 。 本 实例 为 读者 进行 智能 家 居 系 统 开发 提供 了 很 好 的 参考 资料 和 素材 ， 和 希 


望 大 家 认真 学 习 。 


14.1 布局 文件 


Фи 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 14 章 \ 布 局 文件 .avi 


将 首先 详细 讲解 组 界面 布局 文件 的 实现 过 程 。 
14.4.1. 主 布局 文件 


布局 文件 即 UI 界面 设计 文件 , 用 于 规划 在 屏幕 中 显示 的 控件 、 图 像 和 文本 元 素 。 在 本 节 的 内 容 中 ， 


编写 主 布局 文件 main.xml， 设 置 屏幕 中 间 显 示 动 态 显示 内 容 ， 屏 幕 底部 为 固定 的 界面 ， 具 体 实现 


代码 如 下 所 示 。 
<RelativeLayout xmins:android="http://schemas.android.com/apk/res/android" 

xmins:custom="http://www.javaeye.com/custom" 

android:orientation="vertical" 

android:layout_width="fill_ parent" 

android:layout height-"fill parent" 

android:id="@-+id/title_relativeLayout" 

android:background="@drawable/one"> 

<- 中 间 动态 显示 界面 -> 

<ViewFlipper android:id="@+id/fliper" 
android:layout_width="fill_ parent" 
android:layout height-"fill parent" 
android:layout_below="@id/title_relativeLayout" 
android:background="#0000" 
android:layout_marginBottom="50.0dip"> 


</ViewFlipper> 


<- 底部 为 固定 的 布局 -> 
<l- 底部 为 固定 的 布局 -> 
<RelativeLayout android:orientation-"horizontal" 
android:layout_width="fill_ parent" 
android:layout height-"wrap content" 
android:layout alignParentBottom-"true" 
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style="@android:style/ButtonBar" 
android:background="@drawable/title_ background"> 
«ImageButton android:background="#0000" android:layout width-"wrap content" 
android:src="@drawable/add" android:id="@+id/imageButton1" android:layout height-"wrap content" 
android:layout alignParentBottom-"true" android:layout_alignParentLeft="true"></ImageButton> 
«ImageButton android:layout height-"wrap content" android:background="#0000" 
android:id="@+id/imageButton2" android:layout width-"wrap content" android:src="@drawable/menu" 
android:layout_alignTop="@+id/imageButton1" android:layout_alignParentRight="true"></ImageButton> 


</RelativeLayout> 
</RelativeLayout> 


14.1.2 ”实现 蓝牙 控制 表面 


编写 文件 bluetooth.xml， 通 过 按钮 控件 、ImageView 控件 和 ToggleButton 控件 实现 蓝牙 控制 界面 ， 
具体 实现 代码 如 下 所 示 。 
«LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:background="@drawable/one"> 
<RelativeLayout android:layout_width="match_parent" android:layout_height="match_parent" 
android:id="@+id/relativeLayout1"> 
<ListView android:id="@+id/IvDevices" android:layout height-"wrap content" 
android:layout width-"match parent" android:layout alignParentLeft-"true" 
android:layout_alignParentBottom="true" android:layout_below="@+id/btnExit"></ListView> 
«Button android:text="Native Bluetooth visibility" android:layout_height="wrap_content" 
android:layout_width="wrap_content" android:textSize="25sp" android:id="@+id/btnDis" 
android:layout_alignParentTop="true" android:layout_alignRight="@+id/imageView1" 
android:layout_marginRight="64dp" android:layout_marginTop="315dp"></Button> 
«Button android:layout_width="wrap_content" android:textSize="25sp" android:id="@+id/btnExit" 
android:layout_height="wrap_content" android:text="Return to home menu" 
android:layout_below="@+id/btnSearch" android:layout_alignRight="@+id/btnSearch" 
android:layout marginTop-"37dp" android:layout_alignLeft="@+id/btnDis"></Button> 
«Button android:layout_width="110dip" android:textSize="25sp" android:id="@+id/btnSearch" 
android:layout_height="50dip" android:text="Search Equipment" android:layout_alignBottom="@+id/btnDis" 
android:layout_alignLeft="@+id/tbtnSwitch"></Button> 
<ToggleButton android:textOff="Off android:layout_width="110dip" android:layout height-"50dip" 
android:textOn="On" android:id="@+id/tbtnSwitch" android:textSize="23sp" android:text="OFF" 
android:layout_alignBottom="@+id/imageView1" android:layout_alignRight="@+id/imageView2" 
android:layout_marginRight="52dp" android:layout_marginBottom="23dp"></ToggleButton> 
<ImageView android:layout_height="wrap_content" android:layout width-"wrap content" 
android:id="@+id/imageView1" android:src="@drawable/lanya" android:layout_above="@+id/btnSearch" 
android:layout_toLeftOf="@+tid/tbtnSwitch" android:layout_marginRight="41dp"></ImageView> 
<ImageView android:layout height-"wrap content" android:layout width-"wrap content" 
android:id="@+id/imageView2" android:src="@drawable/sousuo" android:layout above-"(g)*id/tbtnSwitch" 
android:layout_centerHorizontal="true"></ImageView> 
</RelativeLayout> 
</LinearLayout> 
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14. 


14. 


13 显示 公司 介绍 信息 


编写 文件 company.xml， 功 能 是 显示 公司 介绍 信息 ， 具 体 实现 代码 如 下 所 示 。 
<LinearLayout 
xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:background="@drawable/bac" 
android:layout_height="match_parent"> 
<RelativeLayout android:id="@+id/relativeLayout1" android:layout_width="match_parent" 
android:layout height-"match parent"» 
<ImageView android:src="@drawable/company" android:id="@+id/imageView1" 
android:layout height="wrap content" android:layout width="wrap content" 
android:layout_alignParentBottom="true" android:layout_centerHorizontal="true"></ImageView> 
<ImageButton android:src="@drawable/back" android:background="#0000" 
android:layout height="wrap content" android:id="@+id/back" android:layout width="wrap content" 
android:layout_alignParentBottom="true" android:layout_alignParentRight="true"></ImageButton> 
<ImageView android:src="@drawable/ctitle" android:id="@+id/imageView2" 
android:layout height="wrap content" android:layout width-"wrap content" 
android:layout_alignParentTop="true" android:layout_alignRight="@+id/imageView1" 
android:layout_marginRight="22dp"></ImageView> 
</RelativeLayout> 
</LinearLayout> 


14 系统 功能 介绍 


编写 文件 dialog.xml， 功 能 是 实现 一 个 系统 功能 介绍 对 话 框 效 果 ， 具 体 实现 代码 如 下 所 示 。 
<LinearLayout 
xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:id="@+id/dialog" android:weightSum="1"> 
«RelativeLayout android:id="@+id/relativeLayout1" android:layout width-"match parent" 
android:layout height-"wrap content" android:layout_weight="1.09"> 
<TextView android:text="@string/intr1" android:layout width-"wrap content" 
android:layout height-"wrap content" android:id="@+tid/textView2" 
android:textAppearance="?android:attr/textAppearanceLarge" android:layout_below="@+id/textView1" 
android:layout_alignLeft="@+id/textView 1" android:layout_marginLeft="24dp"></TextView> 
<TextView android:text="@string/intrO" android:layout_width="Wrap_content" 
android:layout_height="wrap_content" android:id="@+id/textView1" 
android:textAppearance="?android:attr/textAppearanceLarge" android:layout_alignParentTop="true" 
android:layout_alignParentLeft="true" android:layout marginLeft-"50dp" 
android:layout_marginTop="53dp"></TextView> 
<TextView android:text="@string/intr2" android:layout width-"wrap content" 
android:layout height-"wrap content" android:id="@+id/textView3" 
android:textAppearance-"?android:attr/textAppearanceLarge" android:layout_below="@+id/textView2" 
android:layout_alignLeft="@+id/textView1"></TextView> 


6. 
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<TextView android:text="@string/intr3" android:layout_width="wrap_content" 
android:layout_height="wrap_content" android:id="@+id/textView4" 
android:textAppearance="?android:attr/textAppearanceLarge" android:layout_below="@+id/textView3" 
android:layout_alignLeft="@+id/textView2"></TextView> 

«ImageView android:id="@+id/imageView1" android:layout width-"wrap content" 
android:layout height-"wrap content" android:src-"(gdrawable/main add enable" 
android:layout_below="@+id/textView4" android:layout_alignLeft="@tid/textView3" 
android:layout_marginTop="37dp"></ImageView> 

<TextView android:text="@string/intr4" android:layout width-"wrap content" 
android:layout height-"wrap content" android:id="@+id/textView5" 
android:textAppearance="?android:attr/textAppearanceLarge" android:layout_alignBottom="@+id/imageView1" 
android:layout_toRightOf="@+id/imageView1" android:layout_marginLeft="34dp"></TextView> 

<ImageView android:id="@+id/imageView2" android:layout_width="wrap_content" 
android:layout_height="wrap_content" android:src="@drawable/main_menu_enable" 
android:layout_below="@+id/imageView1" android:layout_alignLeft="@tid/imageView 1" 
android:layout_marginTop="24dp"></ImageView> 

<TextView android:text="@string/intrS" android:layout width-"wrap content" 
android:layout height-"wrap content" android:id="@+id/textView6" 
android:textAppearance="?android:attr/textAppearanceLarge" android:layout_alignBottom="@+id/imageView2" 
android:layout_alignLeft="@tid/textView5"></TextView> 

<ImageView android:id="@+id/imageView3" android:layout_width="wrap_content" 
android:layout_height="wrap_ content" android:src="@drawable/main_ back enable" 
android:layout_below="@+id/imageView2" android:layout_alignLeft="@+id/imageView2" 
android:layout marginTop-"30dp"»«/ImageView» 

<TextView android:text="@string/intr6" android:layout width-"wrap content" 
android:layout heightz"wrap content" android:id-" (9 *id/text View?" 
android:textAppearance="?android:attr/textAppearanceLarge" android:layout  alignBottom-" (9) *id/imageView3" 
android:layout_alignLeft="@+id/textView6"></TextView> 

<TextView android:text="@string/intr7" android:textColor="#00ff00" 
android:layout_width="wrap_ content" android:layout height-"wrap content" android:id="@+id/textView8" 
android:textAppearance="?android:attr/textAppearanceLarge" android:layout_below="@tid/imageView3" 
android:layout_alignLeft="@+id/imageView3" android:layout_marginTop="52dp"></TextView> 

<TextView android:text="@string/intr8" android:textC olor="#00ff00" 
android:layout width-"wrap content" android:layout height-"wrap content" android:id="@+id/textView9" 
android:textAppearance="?android:attr/textAppearanceLarge" android:layout_below="@+id/textView8" 
android:layout_alignLeft="@+id/textView8" android:layout_marginTop="47dp"></TextView> 

<TextView android:text="@string/intr9" android:textC olor="#00ff00" 
android:layout_width="wrap_content" android:layout height-"wrap content" android:id="@+id/textView10" 
android:textAppearance="?android:attr/textAppearanceLarge" android:layout_below="@+id/textView9" 
android:layout_alignLeft="@+id/textView9" android:layout_marginTop="45dp"></TextView> 

</RelativeLayout> 

</LinearLayout> 


14.1.5 ”第 一 路 调 光 设 置 弄 面 


编写 文件 first.xml, 功能 是 通过 单 选 按 钮 列表 实现 了 第 一 路 调 光 设置 界面 ,具体 实现 代码 如 下 所 示 。 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 

android:layout_width="fill_parent" 

android:layout height-"fill parent" 

android:background-" 0000" 


O 
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android:weightSum="1" android:orientation="vertical"> 
<ImageButton 

android:layout_width="wrap_content" 

android:layout height-"wrap content" 
android:src="@drawable/help_2" 
android:background="#0000" 
android:id="@+id/imageButton1" 
android:layout_gravity="right"></ImageButton> 


<TextView 
android:id="@+id/textview 1" 
android:layout height-"wrap content" 
android:layout width-"wrap content" 
android:layout_alignParentTop="true" 
android:layout_alignParentRight="true" 
android:layout_marginRight="76dp" 
android:layout_marginTop="15dp"></TextView> 
<RelativeLayout 
android:id="@+id/relativeLayout1" 
android:layout_width="match_parent" android:layout height-"696dp" android:gravity="left"> 
<RadioGroup android:layout_height="wrap_content" android:id="@+id/radioGroup1" 
android:layout_width="wrap_content" android:layout alignParentTop-"true" 
android:layout_toRightOf="@+id/imageButton2" android:layout marginLeft-"18dp" 
android:layout_marginTop="32dp"> 
</RadioGroup> 
<ImageButton android:id="@+id/imageButton5" android:layout height-"wrap content" 
android:background-" 440000" android:layout width-"wrap content" android:src="@drawable/button2_c" 
android:layout_alignTop="@+id/imageButton3" 
android:layout_alignLeft="@+id/imageButton4"></ImageButton> 
<RadioGroup android:layout_height="wrap_content" android:id="@+id/radioGroup3" 
android:layout_width="wrap_content" android:layout_alignTop="@+id/radioGroup2" 
android:layout_toRightOf="@+id/radioGroup1" android:layout_marginLeft="45dp"> 
<RadioButton android:text="0%" android:layout height-"wrap content" 
android:id="@+id/radio21" android:layout width-"wrap content" ></RadioButton> 
<RadioButton android:text="20%" android:layout height-"wrap content" 
android:id="@+id/radio22" android:layout width-"wrap content"»«/RadioButton» 
«RadioButton android:text="40%" android:layout height-"wrap content" 
android:id="@+id/radio23" android:layout width-"wrap content"»«/RadioButton» 
<RadioButton android:text="60%" android:layout height-"wrap content" 
android:id="@+id/radio24" android:layout width-"wrap content"»«/RadioButton» 
<RadioButton android:text="80%" android:layout height-"wrap content" 
android:id="@+id/radio25" android:layout_width="wrap_content"></RadioButton> 
<RadioButton android:text="100%" android:layout height-"wrap content" 
android:id="@+id/radio26" android:layout_width="wrap_content"></RadioButton> 
</RadioGroup> 
«ImageButton android:id="@+id/imageButton4" android:layout height-"wrap content" 
android:background="#0000" android:layout width-"wrap content" android:src="@drawable/button2_o" 
android:layout_alignTop="@+id/imageButton2" android:layout toRightOf-"(g)*id/radioGroup 1" 
android:layout_marginLeft="24dp"></ImageButton> 
<RadioGroup android:layout height-"wrap content" android:id="@+id/radioGroup4" 
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android:layout_width="wrap_content" android:layout_alignTop="@+id/radioGroup3" 
android:layout_toRightOf="@+id/imageButton4" android:layout marginLeft-"76dp"» 
<RadioButton android:text="0%" android:layout height-"wrap content" 
android:id="@+id/radio31" android:layout width-"wrap content"»«/RadioButton» 
«RadioButton android:text="20%" android:layout height-"wrap content" 
android:id="@+id/radio32" android:layout width-"wrap content"»«/RadioButton» 
<RadioButton android:text="40%" android:layout height-"wrap content" 
android:id="@+id/radio33" android:layout width-"wrap content"»«/RadioButton» 
<RadioButton android:text="60%" android:layout width-"wrap content" android:id-"(Q)*id/radio34" 
android:layout height-"wrap content" android:layout below-"(g)*id/radioGroup4" 
android:layout_alignLeft="@+id/radioGroup4"></RadioButton> 
«RadioButton android:text="80%" android:layout_width="wrap_content" android:id="@+id/radio35" 
android:layout_height="wrap_content" android:layout_below="@+id/radioButton4" 
android:layout_alignLeft="@+id/radioButton4"></RadioButton> 
«RadioButton android:text="100%" android:layout_width="wrap_content" android:id="@+id/radio36" 
android:layout_height="wrap_ content" android:layout below-"(g)*id/radioButton5" 
android:layout_alignLeft="@+id/radioButton5"></RadioButton> 
</RadioGroup> 
<TextView android:layout_height="wrap_content" android:text=" 第 三 路 调 光 " 
android:textColor="#ffffff" android:id="@+id/textView4" android:layout_width="wrap_content" 
android:layout_alignTop="@+id/textView2" android:layout_alignLeft="@tid/radioGroup4"></TextView> 
<ImageButton android:layout_width="wrap_content" android:layout_height="wrap_content" 
android:src="@drawable/button3_c" android:background="#0000" android:id="@+id/imageButton7" 
android:layout_alignTop="@+id/imageButton5" 
android:layout_alignLeft="@tid/imageButton6"></ImageButton> 
<ImageButton android:layout_width="wrap_content" android:layout height-"wrap content" 
android:src="@drawable/button3_o" android:background-" 40000" android:id="@+id/imageButton6" 
android:layout_alignTop="@+id/imageButton4" android:layout_toRightOf="@+id/imageButton4" 
android:layout_marginLeft="56dp"></ImageButton> 
<TextView android:layout_width="wrap_content" android:text= "第 四 路 调 光 " 
android:layout_height="wrap_content" android:id="@+id/textView5" android:textColor="#ffffff" 
android:layout_alignTop="@+id/textView4" android:layout_alignRight="@+id/radioGroup5"></TextView> 
<ImageButton android:src="@drawable/button4_c" android:layout height="wrap content" 
android:id="@+id/imageButton9" android:background="#0000" android:layout_width="wrap_content" 
android:layout_alignTop="@+id/imageButton7" 
android:layout_alignLeft="@+id/imageButton8"></ImageButton> 
<ImageButton android:src="@drawable/split" android:layout height-"wrap content" 
android:id="@+id/imageButton10" android:background="#0000" android:layout width-"1000dip" 
android:layout_alignTop="@+id/radioGroup2" android:layout_alignRight="@+id/radioGroup4" 
android:layout_marginTop="47dp"></ImageButton> 
<ImageButton android:src="@drawable/split" android:layout height-"wrap content" 
android:id-"(g)*id/imageButton11" android:background="#0000" android:layout width-"wrap content" 
android:layout_alignTop="@+id/imageButton1 0" 
android:layout_alignRight="@+id/radioGroup5"></ImageButton> 
<ImageButton android:background="#0000" android:layout height-"wrap content" 
android:src="@drawable/split" android:id="@+id/imageButton1 2" android:layout width-"wrap content" 
android:layout_below="@+id/imageButton10" android:layout_alignLeft="@+id/radioGroup2" 
android:layout_marginTop="35dp"></ImageButton> 
<ImageButton android:background="#0000" android:layout height-"wrap content" 
android:src="@drawable/split" android:id="@+id/imageButton1 5" android:layout width-"wrap content" 


android:layout_alignTop="@+id/imageButton1 2" 
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android:layout_alignRight="@+id/radioGroup5"></ImageButton> 
<ImageButton android:background="#0000" android:layout height="wrap content" 
android:src="@drawable/split" android:id="@+id/imageButton1 3" android:layout_width="wrap_content" 
android:layout_below="@+id/imageButton12" android:layout_alignRight="@+id/imageButton4" 
android:layout_marginTop="43dp"></ImageButton> 
<ImageButton android:background="#0000" android:layout height-"wrap content" 
android:src="@drawable/split" android:id="@+id/imageButton17" android:layout width-"wrap content" 
android:layout_alignTop="@+id/imageButton1 3" 
android:layout_alignRight="@+id/radioGroup5"></ImageButton> 
«ImageButton android:background="#0000" android:layout height-"wrap content" 
android:src="@drawable/split" android:id="@+id/imageButton18" android:layout width-"wrap content" 
android:layout_below="@+id/imageButton13" android:layout_alignLeft="@+id/imageButton13" 
android:layout_marginTop="39dp"></ImageButton> 
<ImageButton android:background="#0000" android:layout_height="wrap_content" 
android:src="@drawable/split" android:id="@+id/imageButton1 9" android:layout_width="wrap_content" 
android:layout_alignTop="@+id/imageButton1 8" 
android:layout_alignRight="@+id/radioGroup5"></ImageButton> 
<ImageButton android:id="@+id/imageButton3" android:layout width-"wrap content" 
android:src="@drawable/button1_c" android:layout height-"wrap content" android:background="#0000" 
android:layout_below="@+id/imageButton2" android:layout_alignLeft="@+id/imageButton2" 
android:layout_marginTop="30dp"></ImageButton> 
<RadioGroup android:layout_width="wrap_ content" android:id="@+id/radioGroup2" 
android:layout_height="wrap_content" android:layout_below="@+id/radioGroup1" 
android:layout alignParentLeft-"true" android:layout_marginLeft="179dp" android:layout marginTop-"105dp"» 
«RadioButton android:layout height-"wrap content" android:layout width-"wrap content" 
android:text="0%" android:id="@+id/radio11"></RadioButton> 
<RadioButton android:layout height-"wrap content" android:layout width-"wrap content" 
android:text="20%" android:id="@+id/radio12"></RadioButton> 
<RadioButton android:layout_height="wrap_content" android:layout_width="wrap_content" 
android:text="40%" android:id="@+id/radio13"></RadioButton> 
«RadioButton ^ android:layout height-"wrap content"  android:layout width-"wrap content" 
android:text="60%" android:id="@+id/radio14"></RadioButton> 
«RadioButton android:layout_height="wrap_content" android:layout width-"wrap content" 
android:text="80%" android:id="@+id/radio15"></RadioButton> 
<RadioButton android:layout height-"wrap content" android:layout_width="wrap_content" 
android:text="100%" android:id="@+id/radio16"></RadioButton> 
</RadioGroup> 
<TextView android:text=" 第 二 路 调 光 " android:textColor="#ffffff" android:layout_width="wrap_content" 
android:id="@+id/textView2" android:layout height="wrap content" android:layout_alignTop="@+id/textView3" 
android:layout_alignLeft="@+id/radioGroup3"></TextView> 
<TextView android:text= "第 一 路 调 光 " android:textColor="#ffffff" android:layout_width="wrap_content" 
android:id="@+id/textView3" android:layout height-"wrap content" android:layout_below="@+id/radioGroup1" 
android:layout_alignLeft="@+id/radioGroup2" android:layout marginTop-"44dp"»«/TextView» 
<TextView android:text-" —" android:layout width-"wrap content" android:id="@+id/textView7" 
android:textSize="30sp" android:layout height-"wrap content" android:layout_below="@+id/imageButton11" 
android:layout_alignRight="@+id/textView6"></TextView> 
<TextView android:text-" 8" android:layout width-"wrap content" android:id="@+id/textView8" 
android:textSize="30sp" android:layout height-"wrap content" android:layout below-"(Q)*id/imageButton 15" 
android:layout_alignRight="@+id/textView7"></TextView> 
<TextView android:text-" Ф" android:layout width-"wrap content" android:id="@+id/textView9" 
android:textSize="30sp" android:layout height-"wrap content" android:layout_below="@+id/imageButton17" 
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android:layout_alignRight="@+id/textView8"></TextView> 
<TextView android:text=" Я" android:layout_width="wrap_content" 
android:id="@+id/textView10" android:textSize="30sp" android:layout height="wrap content" 
android:layout_below="@+id/imageButton19" android:layout_alignRight="@+id/textView9"></TextView> 
<ImageButton android:id="@+id/imageButton8" android:layout width-"wrap content" 
android:src-"(drawable/button4 o" android:layout height-"wrap content" android:background-" 40000" 
android:layout_alignTop="@+id/imageButton6" android:layout toRightOf-"(g)*id/imageButton6" 
android:layout_marginLeft="39dp"></ImageButton> 
<RadioGroup android:layout width-"wrap content" android:id="@+id/radioGroup5" 
android:layout height-"wrap content" android:layout alignTop-"(Q)*id/radioGroup4" 
android:layout_alignRight="@+id/imageButton8"> 
«RadioButton android:layout_height="wrap_ content" android:layout_width="wrap_content" 
android:text="0%" android:id="@+id/radio41"></RadioButton> 
<RadioButton android:layout_height="wrap_content" android:layout_width="wrap_content" 
android:text="20%" android:id="@+id/radio42"></RadioButton> 
<RadioButton android:layout_height="wrap_content" android:layout width-"wrap content" 
android:text="40%" android:id="@+id/radio43"></RadioButton> 
<RadioButton android:layout_height="wrap_content" android:layout_width="wrap_content" 
android:text="60%" android:id="@tid/radio44"></RadioButton> 
<RadioButton android:layout_height="wrap_content" android:layout_width="wrap_content" 
android:text="80%" android:id="@+id/radio45"></RadioButton> 
«RadioButton android:layout_height="wrap_ content" android:layout_width="wrap_content" 
android:text="100%" android:id="@+id/radio46"></RadioButton> 
</RadioGroup> 
<ImageButton android:id="@+id/imageButton14" android:layout_width="1000dip" 
android:src="@drawable/line" android:layout_height="5dip" 
android:layout_below="@+id/radioGroup3"></ImageButton> 
<ImageButton android:layout_width="5dip" android:src="@drawable/line" 
android:layout_height="1000dip" android:id="@+id/imageButton 16" android:layout alignParentTop-"true" 
android:layout_toRightOf="@+id/textView5" android:layout_marginLeft="46dp"></ImageButton> 
<TextView android:textSize="30sp" android:layout width-"wrap content" android:text=" ж" 
android:id="@+id/textView6" android:layout height-"wrap content" 
android:layout_alignTop="@+id/radioGroup5" android:layout_toRightOf="@+id/imageButton16" 
android:layout_marginLeft="24dp"></TextView> 
<ImageButton android:layout_width="wrap_content" android:src="@drawable/button1_add_x" 
android:layout height-"wrap content" android:background="#0000" android:id="@+id/imageButton2" 
android:layout_below="@+id/imageButton14" android:layout_alignRight="@+id/radioGroup2" 
android:layout_marginTop="56dp"></ImageButton> 
<TextView android:id="@tid/textView11" android:text=" 面 " android:textSize="30sp" 
android:layout_height="wrap_content" android:layout_width="wrap_content" 
android:layout_above="@+id/imageButton14" android:layout_alignLeft="@+id/textView10"></TextView> 
«ImageButton android:layout_height="wrap_content" android:background="#0000" 
android:id="@+id/btnopen" android:layout width="wrap content" android:src="@drawable/allop" 
android:layout_alignTop="@+id/imageButton8" android:layout_alignLeft="@+id/textView11"></ImageButton> 
<ImageButton android:layout_height="wrap_content" android:id="@+id/btnclose" 
android:layout_width="wrap_content" android:src="@drawable/allcl" android:background="#0000" 
android:layout_alignTop="@+id/imageButton9" android:layout_alignLeft="@+id/btnopen"></ImageButton> 


</RelativeLayout> 


</LinearLayout> 
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编写 文件 home.xml， 此 文件 是 系统 执行 后 进入 的 主 界面 ， 具 体 实现 代码 如 下 所 示 。 
<LinearLayout 
xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width-"match parent" 
android:background="@drawable/bac" 
android:layout_height="match_parent" android:weightSum="1"> 
<RelativeLayout android:id="@+id/relativeLayout1" android:layout_width="match parent" android:layout_ 
height="682dp"> 
<ImageView android:layout_alignParentLeft="true" android:id="@+id/imageView2" android:src= 
"(Qdrawable/enter1" android:layout height-"wrap content" android:layout_width="wrap_content" android:layout 
_below="@+id/imageView1"></ImageView> 
<ImageView android:id="@+id/imageView4" android:src="@drawable/enter2" android:layout height- 
"wrap content" android:layout_width="wrap_content" android:layout_below="@+id/imageView2" android: 
layout_alignParentLeft="true" android:layout_marginLeft="48dp" android:layout_marginTop="86dp"></ImageView> 
<ImageView android:id="@+id/imageView5" android:src="@drawable/enter3" android:layout height- 
"wrap content" android:layout_width="wrap_content" android:layout_alignParentBottom="true" android:layout_ 
alignLeft= "@+id/imageView4" android:layout_marginBottom="66dp"></ImageView> 
«ImageView android:id="@+id/imageView7" android:src="@drawable/split" android:layout height- 
"wrap. content" android:layout width-"wrap content" android:layout_alignBottom="@+id/imageView5" android: 
layout_alignLeft="@+id/imageView6"></ImageView> 
<ImageButton android:id="@+id/Enterp" android:background="#0000" android:src="@drawable/ 
enter0" android:layout height-"wrap content" android:layout_width="wrap_content" android:layout_ 
alignBottom="@+id/imageView6" android:layout_alignLeft="@+id/Enterr"></ImageButton> 
«|mageButton android:id="@+id/Enterc" android:background="#0000" android:src="@drawable/ 
enter0" android:layout height-"wrap content" android:layout_width="wrap_content" android:layout above- 
"@tid/imageView7" android:layout_alignLeft="@+id/Enterp"></ImageButton> 
<ImageView android:id="@+id/imageView6" android:src="@drawable/split" android:layout_height= 
"wrap content" android:layout_width="wrap_content" android:layout_below="@+id/imageView4" android: 
layout_alignLeft="@+id/imageView3"></ImageView> 
<ImageView android:id="@+id/imageView1" android:src="@drawable/logo" android:layout_height= 
"wrap content" android:layout_width="wrap_content" android:layout_alignParentTop="true" android:layout_ 
centerHorizontal="true"></ImageView> 
«ImageButton android:background="#0000" android:id="@+id/Enterr" android:src="@drawable/enter0" 
android:layout_height="wrap_content" android:layout width-"wrap content" android:layout_alignBottom="@+id/ 
imageView3" android:layout_toRightOf="@+id/imageView1" android:layout_marginLeft="63dp"></ImageButton> 
<ImageView android:id="@+id/imageView3" android:src="@drawable/split" android:layout height- 
"wrap content" android:layout width-"wrap content" android:layout_below="@+id/imageView2" android:layout_ 
alignRight="@+id/imageView1" android:layout_marginRight="87dp"></ImageView> 


</RelativeLayout> 
<RelativeLayout android:layout_weight="0.95" android:layout_height="wrap_content" android:id="@+id/ 
relativeLayout2" android:layout_width="match_parent"></RelativeLayout> 
<RelativeLayout android:layout width-"fill parent" 
android:layout_height="wrap_content" 
android:layout alignParentBottom-"true" 
style="@android:style/ButtonBar" 
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android:background="@drawable/title_background"> 

<ImageButton android:layout width-"wrap content" android:layout height-"wrap content" android: 
background="#0000" android:id="@+id/back" android:src="@drawable/back" android:layout centerHorizontal- 
"true" android:layout_alignTop="@t+id/imageButton3"></ImageButton> ></RelativeLayout> 
</LinearLayout> 


1.7 不 同房 间 的 照明 亮度 参考 值 


编写 文件 lightstandard.xml， 功 能 是 显示 不 同房 间 的 照明 亮度 参考 值 ， 具 体 实现 代码 如 下 所 示 。 
<LinearLayout 
xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:background="@drawable/bac" 
android:id="@+id/stand" android:weightSum="1"> 
<RelativeLayout android:id="@+id/relativeLayout1" android:layout width-"match parent" android:layout_ 
height="wrap_content" android:layout_weight="1.09"> 
<ImageView android:layout height-"wrap content" android:src="@drawable/twitter1" android:id= "@+id/ 
imageView1" android:background="#0000" android:layout_width="wrap_content" android:layout alignParentTop= 
"true" android:layout_alignRight="@+id/imageView2" android:layout marginRight-"119dp"»«/ImageView» 
<ImageView android:layout height-"wrap content" android:src="@drawable/stand1" android:id= 
"@tid/imageView2" android:layout width-"wrap content" android:layout_below="@+id/imageView1" android: 
layout alignParentRight-"true" android:layout marginRight-"173dp"»«/ImageView» 
</RelativeLayout> 
</LinearLayout> 


1.8 产品 的 详细 介绍 


编写 文件 productxml， 功 能 是 显示 本 产品 的 详细 介绍 信息 ， 有 具体 实现 代码 如 下 所 示 。 
<LinearLayout 
xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:background="@drawable/bac" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 
<RelativeLayout android:id="@+id/relativeLayout1" android:layout height-"match parent" android:layout_ 
width="match_parent"> 
<ImageButton android:src="@drawable/back" android:background="#0000" android:layout height- 
"wrap content" android:id="@+id/back" android:layout width-"wrap content" android:layout_alignParent 
Bottom="true" android:layout alignParentRight-"true"» «/ImageButton» 
<ImageView android:src="@drawable/product" android:id="@+id/imageView1" android:layout_ height=" 
wrap content" android:layout_width="Wrap_content" android:layout_above="@+id/back" android:layout_ align 
ParentLeft= "true" android:layout marginLeft-"117dp" android:layout_marginBottom="3 1dp"></ImageView> 
<ImageView android:src="@drawable/title" android:id="@+id/imageView2" android:layout height- 
"wrap content" android:layout_width="wrap_content" android:layout alignParentTop-"true" android:layout_ 
alignLeft="@+id/imageView1" android:layout_marginLeft="59dp" android:layout_marginTop="42dp"></ImageView> 


</RelativeLayout> 
© 


</LinearLayout> 


Android kB TER Sc 


14.4.9 五 路 调 光 设 置 界面 


编写 文件 second.xml， 功 能 是 通过 单 选 按钮 列表 实现 一 个 五 路 调 光 设置 界面 效果 ， 
如 下 所 示 。 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:layout_width="fill_ parent" 
android:layout height-"fill parent" 
android:background="#0000" 
android:weightSum="1" android: orientation="vertical"> 
«ImageButton 

android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:src="@drawable/help_2" 
android:background="#0000" 
android:id="@+id/imageButton1" 
android:layout_gravity="right"></ImageButton> 


<TextView 

android:id="@+id/textview 1" 

android:layout height-"wrap content" 
android:layout widthz"wrap content" 
android:layout_alignParentTop="true" 
android:layout_alignParentRight="true" 
android:layout_marginRight="76dp" 
android:layout_marginTop="15dp"></TextView> 
<RelativeLayout 
android:id="@+id/relativeLayout1" 


具体 实现 代码 


android:layout_width="match_parent" android:layout height-"696dp" android:gravity="left"> 


<RadioGroup android:layout_height="wrap_content" android:id="@+id/radioGroup1" 


android:layout_width="wrap_content" android:layout_alignParentTop="true" 
android:layout_toRightOf="@+id/imageButton2" android:layout_marginLeft="18dp" 
android:layout_marginTop="32dp"> 


</RadioGroup> 
<ImageButton android:layout width-"wrap content" android:id="@+id/imageButton3" 


android:background="#0000" android:layout height-z"wrap content" android:src="@drawable/button5 c" 
android:layout_below="@+id/imageButton2" android:layout_alignLeft="@+id/imageButton2" 
android:layout_marginTop="26dp"></ImageButton> 


«ImageButton android:id="@+id/imageButton5" android:layout height-"wrap content" 


android:background="#0000" android:layout width-"wrap content" android:src="@drawable/button6_c" 
android:layout_alignTop="@+id/imageButton3" 


android:layout_alignLeft="@+id/imageButton4"></ImageButton> 


<RadioGroup android:layout height-"wrap content" android:id="@+id/radioGroup3" 


android:layout width-"wrap content" android:layout_alignTop="@+id/radioGroup2" 
android:layout_toRightOf="@+id/radioGroup1" android:layout marginLeft-"45dp"» 
«RadioButton android:text="0%" android:layout height-"wrap content" 
android:id="@+id/radio21" android:layout width-"wrap content" ></RadioButton> 
<RadioButton android:text="20%" android:layout height-"wrap content" 
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android:id="@+id/radio22" android:layout_width="wrap_content"></RadioButton> 
<RadioButton android:text="40%" android:layout height-"wrap content" 
android:id="@+id/radio23" android:layout_width="wrap_content"></RadioButton> 
«RadioButton android:text="60%" android:layout height-"wrap content" 
android:id="@+id/radio24" android:layout width-"wrap content"»«/RadioButton» 
«RadioButton android:text="80%" android:layout height-"wrap content" 
android:id="@+id/radio25" android:layout_width="wrap_content"></RadioButton> 
«RadioButton android:text="100%" android:layout height-"wrap content" 
android:id="@+id/radio26" android:layout width-"wrap content"»«/RadioButton» 
</RadioGroup> 
<ImageButton android:id="@+id/imageButton4" android:layout height-"wrap content" 
android:background="#0000" android:layout width-"wrap content" android:src="@drawable/button6_o" 
android:layout align Top-"(Q)*id/imageButton2" android:layout toRightOf-"(Q)*id/radioGroup 1" 
android:layout_marginLeft="24dp"></ImageButton> 
<RadioGroup android:layout_height="wrap_content" android:id="@+id/radioGroup4" 
android:layout_width="wrap_content" android:layout_alignTop="@+id/radioGroup3" 
android:layout_toRightOf="@+id/imageButton4" android:layout_marginLeft="76dp"> 
«RadioButton android:text="0%" android:layout_height="wrap_content" 
android:id="@+id/radio31" android:layout_width="wrap_content"></RadioButton> 
«RadioButton android:text="20%" android:layout height-"wrap content" 
android:id="@+id/radio32" android:layout_width="wrap_content"></RadioButton> 
<RadioButton android:text="40%" android:layout height-"wrap content" 
android:id="@+id/radio33" android:layout width-"wrap content"»«/RadioButton» 

«RadioButton android:text="60%" android:layout width-"wrap content" android:id="@+id/radio34" 
android:layout height-"wrap content" android:layout_below="@+id/radioGroup4" 
android:layout_alignLeft="@+id/radioGroup4"></RadioButton> 

«RadioButton android:text="80%" android:layout width-"wrap content" android:id="@+id/radio35" 
android:layout height-"wrap content" android:layout_below="@+id/radioButton4" 
android:layout_alignLeft="@+id/radioButton4"></RadioButton> 

«RadioButton android:text="100%" android:layout_width="wrap_content" android:id="@+id/radio36" 
android:layout_height="wrap_content" android:layout_below="@+id/radioButton5" 
android:layout_alignLeft="@+id/radioButton5"></RadioButton></RadioGroup> 

<TextView android:layout_height="wrap_content" android:text=" 第 七 路 调 光 " 
android:textColor="#ffffff" android:id="@+id/textView4" android:layout_width="wrap_content" 
android:layout_alignTop="@+id/textView2" android:layout_alignLeft="@+id/radioGroup4"></TextView> 

«ImageButton android:layout width-"wrap content" android:layout height-"wrap content" 
android:src="@drawable/button7_c" android:background-" 40000" android:id="@+id/imageButton7" 
android:layout_alignTop="@+id/imageButton5" 
android:layout_alignLeft="@+id/imageButton6"></ImageButton> 

<ImageButton android:layout_width="wrap_content" android:layout_height="wrap_content" 
android:src="@drawable/button7_o" android:background="#0000" android:id="@+id/imageButton6" 
android:layout_alignTop="@+id/imageButton4" android:layout_toRightOf="@+id/imageButton4" 
android:layout_marginLeft="56dp"></ImageButton> 

<TextView android:layout_height="wrap_content" android:text=" 第 八路 调 光 " 
android:textColor="#ffffff' android:id="@+id/textView5" android:layout width-"wrap content" 
android:layout_alignTop="@+id/textView4" android:layout alignLeft-"(G)*id/radioGroup5"» «/TextView» 

«ImageButton android:layout width-"wrap content" android:layout height-"wrap content" 
android:src="@drawable/button8_c" android:background="#0000" android:id-" (à) *id/imageButton9" 
android:layout_alignTop="@+id/imageButton7" 
android:layout_alignLeft="@+id/imageButton8"></ImageButton> 

<RadioGroup android:id="@+id/radioGroup2" android:layout width-"wrap content" 
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android:layout_height="wrap_content" android:layout_below="@+id/radioGroup1" 
android:layout alignParentLeft-"true" android:layout marginLeft-"207dp" android:layout marginTop-"84dp"» 
<RadioButton android:text="0%" android:id="@+id/radio1 1" 
android:layout_width="wrap_content" android:layout_height="wrap_content"></RadioButton> 
<RadioButton android:text="20%" android:id="@+id/radio12" 
android:layout_width="wrap_content" android:layout_height="wrap_content"></RadioButton> 
<RadioButton android:text="40%" android:id="@+id/radio13" 
android:layout_width="wrap_content" android:layout height-"wrap content"»«/RadioButton» 
<RadioButton android:text="60%" android:id="@+id/radio14" 
android:layout_width="wrap_content" android:layout_height="wrap_content"></RadioButton> 
<RadioButton android:text="80%" android:id="@+id/radio15" 
android:layout width-"wrap content" android:layout_height="wrap_content"></RadioButton> 
«RadioButton android:text="100%" android:id="@+id/radio16" 
android:layout_width="wrap_content" android:layout_height="wrap_content"></RadioButton> 
</RadioGroup> 
<TextView android:textColor="#ffffff" android:layout widthz"wrap content" android:text=" 第 五 路 调 光 " 
android:id="@+id/textView3" android:layout_height="wrap_content" android:layout_below="@+id/radioGroup1" 
android:layout_alignLeft="@+id/radioGroup2" android:layout_marginTop="31dp"></TextView> 
<ImageButton android:layout width-"wrap content" android:src="@drawable/button5_o" 
android:layout height-"wrap content" android:background-" 40000" android:id="@+id/imageButton2" 
android:layout_below="@+id/radioGroup2" android:layout_alignRight="@+id/radioGroup2" 
android:layout marginTop-"76dp"»«/ImageButton» 
<TextView android:textColor="#ffffff" android:layout width-"wrap content" android:text=" 第 六 路 调 光 " 
android:id="@+id/textView2" android:layout_height="wrap_content" android:layout_alignTop="@+id/textView3" 
android:layout_alignLeft="@+id/radioGroup3"></TextView> 
<RadioGroup android:id="@+id/radioGroup5" android:layout_width="wrap_content" 
android:layout height-"wrap content" android:layout_alignTop="@+id/radioGroup4" 
android:layout_toRightOf="@+id/imageButton6" android:layout_marginLeft="59dp"> 
«RadioButton android:text="0%" android:id="@+id/radio4 1" 
android:layout_width="wrap_content" android:layout height-"wrap content"»«/RadioButton» 
«RadioButton android:text-" 2095" android:id="@+id/radio42" 
android:layout width-"wrap content" android:layout_height="wrap_content"></RadioButton> 
«RadioButton android:text="40%" android:id="@+id/radio43" 
android:layout_width="wrap_content" android:layout height-"wrap content"»«/RadioButton? 
«RadioButton android:text="60%" android:id="@+id/radio44" 
android:layout_width="wrap_content" android:layout_height="wrap_content"></RadioButton> 
<RadioButton android:text="80%" android:id="@+id/radio45" 
android:layout_width="wrap_content" android:layout_height="wrap_content"></RadioButton> 
<RadioButton android:text="100%" android:id="@+id/radio46" 
android:layout width-"wrap content" android:layout_height="wrap_content"></RadioButton> 
</RadioGroup> 
<ImageButton android:layout_width="wrap_content" android:src="@drawable/button8_o" 
android:layout_height="wrap_content" android:background="#0000" android:id="@+id/imageButton8" 
android:layout_alignTop="@+id/imageButton6" android:layout toRightOf-"(g)*id/imageButton6" 
android:layout_marginLeft="39dp"></ImageButton> 
<ImageButton android:layout_width="wrap_content" android:src="@drawable/split" 
android:layout_height="wrap_content" android:background="#0000" android:id="@+id/imageButton10" 
android:layout_alignTop="@+id/radioGroup3" android:layout_alignRight="@+id/radioGroup3" 
android:layout_marginTop="42dp"></ImageButton> 
«ImageButton android:layout_width="wrap_content" android:src="@drawable/split" 
android:layout_height="wrap_content" android:background="#0000" android:id="@+id/imageButton1 1" 
android:layout_below="@+id/imageButton10" android:layout_alignRight="@+id/radioGroup3" 
android:layout_marginTop="43dp"></ImageButton> 
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<ImageButton android:layout_width="wrap_content" android:src="@drawable/split" 
android:layout height-"wrap content" android:background="#0000" android:id="@+id/imageButton1 2" 
android:layout_below="@+id/imageButton11" android:layout_alignRight="@+id/textView2" 
android:layout_marginTop="42dp"></ImageButton> 

<ImageButton android:layout width-"wrap content" android:src="@drawable/split" 
android:layout height-"wrap content" android:background-" 40000" android:id="@+id/imageButton13" 
android:layout_alignBottom="@+id/radioGroup3" android:layout_alignRight="@+id/radioGroup3" 
android:layout_marginBottom="46dp"></ImageButton> 

<ImageButton android:layout_width="wrap_content" android:src="@drawable/split" 
android:layout_height="wrap_content" android:background="#0000" android:id="@+id/imageButton14" 
android:layout_alignTop="@+id/imageButton1 0" android:layout_alignRight="@+id/textView5"></ImageButton> 

<ImageButton android:layout_width="wrap_content" android:src="@drawable/split" 
android:layout_height="wrap_content" android:background="#0000" android:id="@+id/imageButton15" 
android:layout_alignTop="@+id/imageButton1 1" 
android:layout_alignRight="@+id/radioGroup5"></ImageButton> 

<ImageButton android:layout_width="wrap_content" android:src="@drawable/split" 
android:layout height-"wrap content" android:background="#0000" android:id="@+id/imageButton16" 
android:layout_alignTop="@+id/imageButton1 2" 
android:layout_alignRight="@+id/radioGroup5"></ImageButton> 

<ImageButton android:layout_width="wrap_content" android:src="@drawable/split" 
android:layout height-"wrap content" android:background="#0000" android:id="@+id/imageButton17" 
android:layout_alignTop="@+id/imageButton1 3" 
android:layout_alignRight="@+id/radioGroup5"></ImageButton> 

<ImageButton android:layout width-"1000dip" android:src="@drawable/line" 
android:layout_height="5dip" android:id="@+id/imageButton1 8" android:layout_below="@+tid/radioGroup3" 
android:layout_alignParentLeft="true" android:layout_marginTop="29dp"></ImageButton> 

<ImageButton android:layout width-"5dip" android:src="@drawable/line" 
android:layout_height="800dip" android:id="@+id/imageButton19" android:layout alignParentTop-"true" 
android:layout_above="@+id/imageButton9" android:layout_toRightOf="@+id/imageButton9"></ImageButton> 

<TextView android:layout_width="wrap_content" android:text=” =" android:textSize="30sp" 
android:id="@+id/textView7" android:layout height-"wrap content" 
android:layout_below="@+id/imageButton14" android:layout_alignRight="@+id/textView6"></TextView> 

<TextView android:layout_width="wrap_content" android:text=" ” 调 " android:textSize="30sp" 
android:id="@+id/textView8" android:layout_height="wrap_content" 
android:layout_below="@+id/imageButton15" android:layout_alignRight="@+id/textView7"></TextView> 

<TextView android:layout_width="wrap_content" android:text-" X" android:textSize="30sp" 
android:id="@+id/textView9" android:layout height="wrap content" 
android:layout_below="@+id/imageButton16" android:layout_alignRight="@+id/textView8"></TextView> 

<TextView android:layout_height="wrap_content" android:text=" 界 " android:textSize="30sp" 
android:id="@+id/textView10" android:layout width-"wrap content" 
android:layout above-"(Q)*id/imageButton17" android:layout_alignRight="@+tid/textView9"></TextView> 

<TextView android:layout height-"wrap content" android:text=" 面 " android:textSize="30sp" 
android:id="@+id/textView11" android:layout_width="wrap_content" 
android:layout_below="@+id/imageButton17" android:layout_alignRight="@+id/textView10"></TextView> 

<TextView android:layout_height="wrap_content" android:text=" 第 " android:textSize="30sp" 
android:id="@+id/textView6" android:layout_width="wrap_content" android:layout_above="@+id/textView7" 
android:layout toRightOf="@+id/imageButton19"></TextView> 


</RelativeLayout> 


</LinearLayout> 
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142 ”实现 程序 文件 


GH 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 14 章 \ 实 现 程序 文件 .avi 
在 本 章 14.1 的 内 容 中 ， 已 经 介绍 了 布局 文件 的 设计 过 程 。 在 本 节 的 内 容 中 ， 将 详细 讲解 本 系统 实 
例 的 具体 Activity 程序 文件 的 实现 过 程 。 


14.2.1 + Activity 


编写 文件 Main.java， 功 能 是 响应 用 户 按键 处 理事 件 ， 根 据 用 户 触摸 的 选项 来 到 对 应 的 模式 ， 通 过 
动画 效果 过 渡 来 到 HOME 界面 。 文 件 Mainjava 的 具体 实现 代码 如 下 所 示 。 
public class Main extends ActivityGroup implements OnGestureListener,OnTouchListener { 
/声明 ViewFlipper 对 象 
private ViewFlipper m_ViewFlipper; 
/声明 GestureDetector HR 
private GestureDetector m GestureDetector; 
/声明 LocalActivityManager 对 象 
private LocalActivityManager m_ActivityManager; 
private static int FLING MIN DISTANCE = 100; 
private static int FLING_MIN_VELOCITY = 200; 
/定义 自 定义 图 片 加 文字 按钮 ImageButton TR 
IIprivate ImageButton mButton1; 


/| 单 选 按键 部 分 1 

private String[ ] areas = new String[ ]{" 一 般 模式 ", "会 议 模式 ", "视频 模式 "," 迎 接 模 式 ", "Si [B] 

private RadioOnClick radioOnClick = new RadioOnClick(4); 

@SuppressWarnings("unused") 

private ListView RadioListView; 

private ImageButton imagebtn,imagebutton; 

OutputStream tmpOut = null; 

Timer timer=new Timer(); 

@Override 

public void onCreate(Bundle savedinstanceState) 

{ 
super.onCreate(savedinstanceState); 
requestWindowFeature(Window.FEATURE NO TITLE); 
// 设 置 内 容 视图 
setContentView(R.layout.main); 
getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN, 

WindowManager.LayoutParams.FLAG FULLSCREEN); 
imagebutton=(ImageButton )findViewByld(R.id.imageButton1); 
imagebutton.setOnClickListener(new ImageButton.OnClickListener() 
{ 
@Override 
public void onClick(View v) 


{ 
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/*Intent intent=new Intent(); 
intent.setClass(Main.this, stand.class); 
startActivity(intent); 
Main.this.finish(); 
overridePendingTransition(R.anim.zoomin,R.anim.zoomout);*/ 
Layoutinflater inflater = getLayoutinflater(); 
View layout = inflater.inflate(R.layout.lightstandard, 
(ViewGroup) findViewByld(R.id.stand)); 


new AlertDialog.Builder(Main. this) 
.setTitle("Ihe nation! atandard of illumination") 
.setView(layout) 
.setPositiveButton("Return", null) 
I|. setNegativeButton(" Bo", null) 
.Show(); 
} 
} 


y 
// 单 选 按键 部 分 2 
imagebtn=(ImageButton)findViewByld(R.id.imageButton2); 
imagebtn.setOnClickListener(new RadioClickListener()); 
/构建 ViewFlipper 对 象 
m ViewFlipper = (ViewFlipper) findViewByld(R..id.fliper); 
/获取 Activity 消息 
m_ActivityManager = getLocalActivityManager(); 
/注册 一 个 用 于 手势 识别 的 类 
m_GestureDetector = new GestureDetector(this); 
/添加 视图 ， 指 定 每 个 视图 对 应 的 Activity 
m_ViewFlipper.addView((m_ActivityManager.startActivity("", new Intent(Main.this,Firstpage.class)). 
getDecorView()),0); 
m ViewFlipper.addView((m ActivityManager.startActivity("", new Intent(Main.this,Secondpage.class)). 
getDecorView()),1); 
/给 ViewFlipper 设置 一 个 listener 
m_ViewFlipper.setOnTouchListener(this); 
// 默 认为 正在 播放 页 面 并 设置 图 标 
// 设 置 相应 元 素 索 引 显示 的 子 视图 
m_ViewFlipper.setDisplayedChild(0); 
/允许 长 按 住 ViewFlipper， 这 样 才 能 识别 拖 动 等 手势 
m ViewFlipper.setLongClickable(true); 
/监听 
/** Called when the activity is first created. */ 
PELE Button 对 象 */ 
/返回 按钮 按键 事件 
/* btnbac = (ImageButton) findViewByld(R.id.btnback); 
btnbac.setOnClickListener(new ImageButton.OnClickListener()( 
@Override 
public void onClick(View v) 
{ 
II TODO Auto-generated method stub 
Intent intent=new Intent(); 
intent.setClass(Main.this, home.class); 
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startActivity(intent); 

Main.this.finish(); 

overridePendingTransition(R.anim.zoomin,R.anim.zoomout); 

l'Intent intent = new Intent(); 

intent.setClass(Main.this, home.class); 
intent.setFlags(Intent.FLAG ACTIVITY CLEAR TOP); /注意 本 行 的 FLAG 设置 
startActivity(intent); 


ЮЛ 
@Override 
public boolean onKeyDown(int keyCode, KeyEvent event) { 
// 按 下 键盘 上 的 返回 键 
if(keyCode == KeyEvent.KEYCODE BACK)( 
new AlertDialog.Builder(this) 
/I.setlcon(R.drawable.services) 
.setTitle(R.string.app about) 
Гаа ER OBES 
// .seticon(R.drawable.hot) 
/设置 弹出 窗口 的 信息 六 
.setMessage(R.string.app about msg) 
.setPositiveButton(R.string.str ok, 
new DialogInterface.OnClickListener() 
{ 
public void onClick(DialogInterface dialoginterface, int i) 


{ 
finish();/* <A O*/ 

} 

} 


) 
жш OBE 
.setNegativeButton(R.string.str no, 
new Dialoglnterface.OnClickListener() 
d 
public void onClick(DialogInterface dialoginterface, int i) 
{ 
} 
» 
.Show(); 
llsetResult(11,this.getintent()); 
return true; 
Jelse( 
return super.onKeyDown(keyCode, event); 
} 


} 
@Override 


protected void onDestroy() { 
super.onDestroy(); 


android.os.Process.killProcess(android.os.Process.myPid()); 
System.exit(0); 
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overridePendingTransition(R.anim.zoomin,R.anim.zoomout); 


/| 或 者 下 面 这 种 方式 


} 

p 

* 定义 从 右 侧 进入 的 动画 效果 

* @return 

al 

public Animation inFromRightAnimation() 
{ 

Animation inFromRight = new TranslateAnimation( 
Animation.RELATIVE_TO_PARENT, +1.0f, 
Animation.RELATIVE_TO_PARENT, 0.0f, 
Animation.RELATIVE TO PARENT, 0.0f, 
Animation.RELATIVE TO PARENT, 0.0f); 

inFromRight.setDuration(500); 

inFromRight.setInterpolator(new Acceleratelnterpolator()); 
return inFromRight; 

) 

p 

* 定义 从 左 侧 退出 的 动画 效果 

* @return 

” 

public Animation outToLeftAnimation() 

{ 

Animation outtoLeft = new TranslateAnimation( 
Animation.RELATIVE_TO_PARENT, 0.0f, 
Animation.RELATIVE ТО PARENT, -1.0f, 
Animation.RELATIVE_TO_PARENT, 0.0f, 
Animation.RELATIVE_TO_PARENT, 0.0f); 

outtoLeft.setDuration(500); 

outtoLeft.setInterpolator(new Acceleratelnterpolator()); 
return outtoLeft; 

} 

p 

* 定义 从 左 侧 进入 的 动画 效果 

* @return 

T 

public Animation inFromLeftAnimation() 

{ 

Animation inFromLeft = new TranslateAnimation( 
Animation.RELATIVE_TO_PARENT, -1.0f, 
Animation.RELATIVE_TO_PARENT, 0.0f, 
Animation.RELATIVE_TO_PARENT, 0.0f, 
Animation.RELATIVE TO PARENT, 0.0f); 

inFromLeft.setDuration(500); 

inFromLeft.setInterpolator(new Acceleratelnterpolator()); 
return inFromLeft; 


} 


411 


E Android 外 设 开 发 实战 


p 
* 定义 从 右 侧 退 出 时 的 动画 效果 
* @return 
7 

public Animation outToRightAnimation() 

{ 

Animation outtoRight = new TranslateAnimation( 
Animation.RELATIVE TO PARENT, 0.0f, 
Animation.RELATIVE_TO_PARENT, +1.0f, 
Animation.RELATIVE_TO_PARENT, 0.0f, 
Animation.RELATIVE TO PARENT, 0.0f); 

outtoRight.setDuration(500); 

outtoRight.setInterpolator(new Acceleratelnterpolator()); 
return outtoRight; 
} 


@Override 
public boolean onDown(MotionEvent e) { 
return false; 
} 
@Override 
public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, 
float velocityY) ( 
// 当 向 左 侧 滑动 的 时 候 
if(e1.getX()-e2.getX()>FLING MIN DISTANCE && Math.abs(velocityX)>FLING MIN VELOCITY) 
{ 
// 设 置 View 进入 屏幕 时 使 用 的 动画 
m_ViewFlipper.setlnAnimation(inFromRightAnimation()); 
I View 退出 屏幕 时 使 用 的 动画 
m_ViewFlipper.setOutAnimation(outToLeftAnimation()); 
/下 一 个 页 面 
m_ViewFlipper.showNext(); 
// 获 取 相应 元 素 索 引 显示 的 子 视 图 


} 
// 当 向 右 侧 滑动 的 时 候 
else if(e2.getX()-e1.getX()>FLING MIN DISTANCE && Math.abs(velocityX)>FLING MIN VELOCITY) 
{ 
IRR. View 进入 屏幕 时 使 用 的 动画 
m ViewFlipper.setlnAnimation(inFromLeftAnimation()); 
Iñ View 退出 屏幕 时 使 用 的 动画 
m_ViewFlipper.setOutAnimation(outToRightAnimation()); 
// 上 一 个 页 面 
m ViewFlipper.showPrevious(); 


// 获 取 相应 元 素 索 引 显示 的 子 视图 


} 

return false; 
} 
@Override 


public void onLongPress(MotionEvent e) { 
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@Override 
public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, 
float distanceY) ( 


return false; 
) 
@Override 
public void onShowPress(MotionEvent e) { 


) 
@Override 
public boolean onSingleTapUp(MotionEvent e) ( 
return false; 
) 
@Override 
public boolean onTouch(View v, MotionEvent event) ( 
/一 定 要 将 触 屏 事件 交 给 手势 识别 类 去 处 理 (自己 处 理会 很 麻烦 的 ) 


return m_GestureDetector.onTouchEvent(event); 


} 


// 单 选 按键 部 分 3 
class RadioClickListener implements OnClickListener { 
@Override 
public void onClick(View v) { 
AlertDialog ad =new AlertDialog.Builder(Main.this).setTitle(" 选 择 模式 ") 
.setSingleChoiceltems(areas,radioOnClick.getlndex(),radioOnClick).create(); 
RadioListView=ad.getListView(); 
ad.show(); 


p 
* 单 击 单 选 按钮 事件 


sj 
class RadioOnClick implements DialogInterface.OnClickListener( 
private int index; 


public RadioOnClick(int index) 
this.index = index; 

} 

public void setlndex(int index)( 
this.index=index; 

} 

public int getindex(){ 
return index; 


} 


public void onClick(DialogInterface dialog, int whichButton){ 
setindex(whichButton); 
11 Toast.makeText(Main.this, "您 选择 了 : " + areas[index], Toast.LENGTH_LONG).show(); 
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switch (index) 


{ 
/一 般 模 式 下 


сазе 0: 


{ 
/人 第 一 个 子 节点 的 亮度 
send(0x01,0x5a); 


// 第 二 个 子 节点 的 亮度 
send(0x02,0x5a); 


/人 第 三 个 子 节点 的 亮度 
send(0x03,0x5a); 


// 第 四 个 子 节点 的 亮度 
send(0x04,0x5a); 
Toast.makeText(Main.this, "您 选择 了 : " + areas[index], Toast.LENGTH LONG).show(); 
dialog.dismiss(); 
} 


һгеак; 


П 会 议 模式 下 


сазе 1: 


{ 
// 第 一 路 子 节点 
send(0x01,0x23); 


// 第 二 路 子 节点 
send(0x02,0x23); 


// 第 三 路 子 节点 
send(0x03,0x23); 


// 第 四 路 子 节点 

send(0x04,0x23); 

Toast.makeText(Main.this, "您 选择 了 : "+ areas[index], Toast.LENGTH_LONG).show(); 
dialog.dismiss(); 

) break; 


// 视 频 模式 下 
сазе 2: 


{ 
/| 第 一 路 子 节点 
send(0x01,0xc8); 


// 第 二 路 子 节 点 
send(0x02,0xc8); 


414 


第 14 章 智能 楼 宇 灯光 控制 系统 


/| 第 三 路 子 节点 
send(0x03,0xc8); 


// 第 四 路 子 节点 
send(0x04,0xc8); 


Toast.makeText(Main.this, "您 选择 了 : "+ areas[index], Toast.LENGTH_LONG).show(); 
dialog.dismiss(); 
) break; 


// 迎 接 模 式 下 


сазе 3: 


{ 
// 第 一 路 子 节点 
send(0x01,0x23); 


// 第 二 路 子 节点 

TimerTask timerTask = new TimerTask() { 
@Override 
public void run() 


// 你 要 干 的 活 
send(0x02,0x23); 
} 

y 
timer.schedule(timerTask, 1000 * 3); 
/| 第 三 路 子 节点 
TimerTask timerTask1 = new TimerTask() { 

@Override 

public void run() { 


/你 要 干 的 活 
send(0x03,0x23); 


} 
} 
timer.schedule(timerTask1, 1000 * 6); //2 秒 后 执行 


// 第 四 路 子 节点 
TimerTask timerTask2 = new TimerTask() { 
@Override 
public void run() { 
// 你 要 干 的 活 
send(0x04,0x23); 


W 

timer.schedule(timerTask2, 1000 * 9); 
Toast.makeText(Main.this, "您 选择 了 : "+ areas[index], Toast.LENGTH_LONG).show(); 
dialog.dismiss(); 
} break; 
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// 返 回 


case 4: 


(//Toast.makeText(Main.this, "您 选择 了 : " + areas[index], Toast.LENGTH_LONG).show(); 
dialog.dismiss(); ) 


private void send(int Room,int Grade)( 


try{ 


IIString strpass="@@UP...."; 
byte[ ] byteone=new byte[8];//=strpass.getBytes("US-ASCII"); 
byteone[0]=(byte)0xf5; 
byteone[1]=(byte)0x5f; 
byteone[2]=(byte)0x00; 
byteone[3]=(byte)Room; 
byteone[4]=(byte)0x03; 
byteone[5]=(byte)0x00; 
byteone[6]=(byte)Grade; 
byteone[7]=(byte)0x06; 


//byte[ ] bytekai=strpass.getBytes("US-ASCII"); 

tmpOut = BluetoothMain.btSocket.getOutputStream(); 

tmpOut.write(byteone);} 

catch (IOException e) { 
Log.e("BluetoothReadService", "temp sockets not created", е); 
} 
} 
» 


14.2.2 监听 单 击 事件 


编写 文件 home java, 功能 是 监听 用 户 触摸 单 击 的 选项 来 执行 对 应 的 处 理 程序 , 来 到 对 应 的 Activity 
界面 。 文 件 homejava 的 具体 实现 代码 如 下 所 示 。 
public class home extends Activity { 
private ImageButton enterr,enterp,enterc, back; 
/** Called when the activity is first created. */ 
@Override 
public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
requestWindowFeature(Window.FEATURE_NO_TITLE); 
setContentView(R.layout.home); 
getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN, 
WindowManager.LayoutParams.FLAG_FULLSCREEN); 
enterr=(ImageButton) findViewByld (R.id.Enterr); 
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enterp=(ImageButton) findViewByld (R.id.Enterp); 
enterc-(ImageButton) findViewByld (R.id.Enterc); 
back-(ImageButton) findViewByld (R.id.back); 
enterr.setOnClickListener(new Button.OnClickListener() 
{ 


@Override 
public void onClick(View v) { 

II TODO Auto-generated method stub 

Intent intent = new Intent(); 
intent.setClass(home.this, BluetoothMain.class); 
intent.setFlags(Inten. FLAG ACTIVITY CLEAR ТОР); // 注 意 本 行 的 FLAG 设置 
startActivity(intent); 

//home.this.finish(); 

overridePendingTransition(R.anim.zoomin,R.anim.zoomout); 


); 


enterp.setOnClickListener(new Button.OnClickListener() 
{ 
@Override 
public void onClick(View v) { 
II TODO Auto-generated method stub 
Intent intent=new Intent(); 
intent.setClass(home.this, product.class); 
startActivity(intent); 
home.this.finish(); 
overridePendingTransition(R.anim.zoomin,R.anim.zoomout); 


» 
); 


enterc.setOnClickListener(new Button.OnClickListener() 


{ 


@Override 
public void onClick(View v) { 

II TODO Auto-generated method stub 

Intent intent=new Intent(); 
intent.setClass(home.this, company.class); 
startActivity(intent); 
home.this.finish(); 
overridePendingTransition(R.anim.zoomin,R.anim.zoomout); 


n 
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back.setOnClickListener(new Button.OnClickListener() 
{ 


@Override 
public void onClick(View v) { 


AlertDialog.Builder alertbBuilder=new AlertDialog.Builder(home.this); 
//.seticon(R.drawable.services) 
alertbBuilder.setTitle(R.string.app_about) 
让 设置 弹出 窗口 的 图 式 */ 
ll.setlcon(R.drawable.hot) 
人 * 设 置 弹出 窗口 的 信息 */ 
.setMessage(R.string.app about msg) 
.setPositiveButton(R.string.str ok, 
new DialogInterface.OnClickListener() 
{ 
public void onClick(DialogInterface dialoginterface, int i) 


{ 
finish();/* 关 闭 窗口 */ 
} 
} 
) 
/设置 弹出 窗口 的 返回 事件 六 
.setNegativeButton(R.string.str no, 
new DialogInterface.OnClickListener() 


{ 
public void onClick(DialogInterface dialoginterface, int i) 


» 
) 


14.2.3 ”设置 系统 的 蓝牙 参数 


编写 文件 BluetoothMain.java， 功 能 是 根据 用 户 的 设置 选项 来 设置 系统 的 蓝牙 参数 ， 实 现 控制 本 系 
统 蓝牙 设备 的 功能 。 文 件 BluetoothMain.java 的 具体 实现 代码 如 下 所 示 。 
public class BluetoothMain extends Activity { 
static final String SPP_UUID = "00001101-0000-1000-8000-00805F9B34FB"; 


Button btnSearch, btnDis, btnExit; 

ToggleButton tbtnSwitch; 

ListView IVBTDevices; 

ArrayAdapter<String> adtDevices; 

List<String> IstDevices = new ArrayList<String>(); 


418 


第 14 章 8663 U LEMAR 


BluetoothAdapter btAdapt; 
public static BluetoothSocket btSocket; 


@Override 

public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout. bluetooth); 
11 Button 设置 
btnSearch = (Button) this.findViewByld(R.id.btnSearch); 
btnSearch.setOnClickListener(new ClickEvent()); 
btnExit = (Button) this.findViewByld(R.id.btnExit); 
btnExit.setOnClickListener(new ClickEvent()); 
btnDis = (Button) this.findViewByld(R.id.btnDis); 
btnDis.setOnClickListener(new ClickEvent()); 


11 ToogleButton 设置 
tbtnSwitch = (ToggleButton) this.find ViewByld(R.id.tbtnSwitch ); 
tbtnSwitch.setOnClickListener(new ClickEvent()); 


II ListView 及 其 数据 源 适 配器 

IvBTDevices = (ListView) this.findViewByld(R.id.lvDevices); 

adtDevices = new ArrayAdapter<String>(BluetoothMain.this, 
android.R.layout.simple list item 1, IstDevices); 

IvBTDevices.setAdapter(adtDevices); 

IIINBTDevices.setOnltemClickListener(new ItemClickEvent()); 


// 初 始 化 本 机 蓝牙 功能 ， 读 取 蓝牙 状态 并 显示 
btAdapt = BluetoothAdapter.getDefaultAdapter(); 
if (btAdapt.getState() == BluetoothAdapter.STATE_OFF) 
tbtnSwitch.setChecked(false); 
else if (btAdapt.getState() == BluetoothAdapter.STATE ON) 
tbtnSwitch.setChecked(true); 


// 注 册 Receiver 来 获取 蓝牙 设备 相关 的 结果 

IntentFilter intent = new IntentFilter(); 

intent.addAction(BluetoothDevice.ACTION_FOUND);// 用 BroadcastReceiver 来 取得 搜索 结果 
intent.addAction(BluetoothDevice.ACTION_BOND_STATE_CHANGED); 
intent.addAction(BluetoothAdapter.ACTION_SCAN_MODE_CHANGED); 
intent.addAction(BluetoothAdapter.ACTION STATE CHANGED); 
registerReceiver(searchDevices, intent); 


if (btAdapt.getState() == BluetoothAdapter.STATE_OFF) (// 如 果 蓝 牙 还 没 开启 
Toast.makeText(BluetoothMain.this, "Bluetooth is openning, Just a minute , please", 1000).show(); 
btAdapt.enable(); 
tbtnSwitch.setChecked(true); 


) 
setTitle("The Bluetooth address: " + btAdapt.getAddress()); 


IstDevices.clear(); 
btAdapt.startDiscovery(); 
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private BroadcastReceiver searchDevices = new BroadcastReceiver() { 


public void onReceive(Context context, Intent intent) { 


String action = intent.getAction(); 
Bundle b = intent.getExtras(); 
Object[ ] IstName = b.keySet().toArray(); 


/显示 所 有 收 到 的 消息 及 其 细节 
for (int i = 0; i < IstName.length; i++) { 
String keyName = IstNamefi].toString(); 
Log.e(keyName, String.valueOf(b.get(keyName))); 
} 


/搜索 设备 时 ， 取 得 设备 的 MAC 地 址 
if (BluetoothDevice.ACTION FOUND.equals(action)) { 
BluetoothDevice device = intent 
.getParcelableExtra(BluetoothDevice.EXTRA DEVICE); 
String str= device.getName() + "|" + device.getAddress(); 
String str1 = device.getAddress(); 
llif(stri.equals("00:11:08:01:06:78") /用 来 判断 是 否 为 我 们 所 需要 的 蓝牙 
IK 


if (IstDevices.indexOf(str) == -1)/ 防 止 重复 添加 
IstDevices.add(str); /获取 设备 名 称 和 mac 地 址 
adtDevices.notifyDataSetChanged(); 
/* 添加 判断 ， 如 果 为 已 配对 或 者 已 存 тас 地 址 的 设备 
* 自动 进行 连接 ， 并 跳 转 到 另 一 个 Activity 
| 
if(trueX ”// 未 添加 条 件 
btAdapt.cancelDiscovery(); 
//String str = IstDevices.get(); 
//String[ ] values = str.split("\\|"); 
//String address-values[1]; 
IILog.e("address",values[1]); 
UUID uuid = UUID fromString(SPP_UUID); 
BluetoothDevice btDev = btAdapt.getRemoteDevice(device.getAddress()); 
try { 
btSocket = btDev 
.createRfcommSocketToServiceRecord(uuid); 
btSocket.connect(); 


Intent intent1 = new Intent(); 

intent1.setClass(BluetoothMain.this, Main.class); 

startActivity (intent1); 

overridePendingTransition(R.anim.zoomin,R.anim.zoomout); 
} catch (lOException e) { 

11 TODO Auto-generated catch block 

e.printStackTrace(); 
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@Override 
protected void onDestroy() { 
this.unregisterReceiver(searchDevices); 
super.onDestroy(); 
android.os.Process.killProcess(android.os.Process.myPid()); 
} 
class ClickEvent implements View.OnClickListener { 
@Override 
public void onClick(View v) { 
if (v == btnSearch)// 搜 索 蓝 牙 设备 ， 在 BroadcastReceiver 显示 结果 
{ 


if (btAdapt.getState() == BluetoothAdapter.STATE_OFF) {// 如 果 蓝 牙 还 没 开启 
Toast.makeText(BluetoothMain.this, "请 先 打开 蓝牙 ", 1000).show(); 


retum; 


} 


setTitle(" 本 机 蓝牙 地 址 : "+ btAdapt.getAddress()); 

lstDevices.clear(); 

btAdapt.startDiscovery(); 

} else if (v == tbtnSwitch) {// 本 机 蓝牙 启动 /关闭 

if (btAdapt.getState() == BluetoothAdapter.STATE OFF)( 
btAdapt.enable(); 
tbtnSwitch.setChecked(true); 

} 


else if (btAdapt.getState() == BluetoothAdapter.STATE_ON){ 
btAdapt.disable(); 
tbtnSwitch.setChecked(false); 
} 
} else if (v == btnDis)// 本 机 可 以 被 搜索 
{ 
Intent discoverablelntent = new Intent( 
BluetoothAdapter.ACTION REQUEST DISCOVERABLE); 
discoverablelntent.putExtra( 


BluetoothAdapter.EXTRA DISCOVERABLE DURATION, 300); 


startActivity(discoverableIntent); 
) else if (v == btnExit) ( 
try { 
if (btSocket != null) 
btSocket.close(); 
} catch (IOException e) { 
e.printStackTrace(); 
} 
if (btAdapt.getState() == BluetoothAdapter.STATE_ON){ 
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btAdapt.disable(); 


BluetoothMain.this.finish(); 


} 
14.2.4 ”控制 第 一 路 光线 的 亮度 


编写 文件 Firstpagejava， 功 能 是 监听 用 户 在 第 一 路 调 光 单 选 按钮 列表 中 的 选择 值 ， 根 据 这 个 值 来 
控制 光线 的 亮度 。 文 件 Firstpagejava 的 具体 实现 代码 如 下 所 示 。 
public class Firstpage extends Activity { 
private ImageButton imagebutton; 
private ImageButton ibutton1_o,ibutton1_c,ibutton2_o,ibutton2_c,ibutton3_o, 
ibutton3 c,ibutton4 ojbutton4 c,btnallop,btnallcl; 
RadioGroup radiogroup0,radiogroup1 ,radiogroup2,radiogroup3; 
RadioButton radio ,radio2,radio3,radio4,radio5,radio6; 
RadioButton radio11,radio12,radio13,radio14,radio15,radio16; 
RadioButton radio21,radio22,radio23,radio24,radio25,radio26; 
RadioButton radio31,radio32,radio33,radio34, radio35,radio36; 
OutputStream tmpOut = null; 
@Override 
protected void onCreate(Bundle savedinstanceState) ( 
super.onCreate(savedinstanceState); 
setContentView(R.layout.first); 
NEF HARA 
btnallop=(ImageButton) find ViewByld(R.id.btnopen); 
btnallop.setOnClickListener(new Button.OnClickListener(){ 
@Override 
public void onClick(View v) 


alo 


{ 
// 第 一 路 灯亮 
send(0x01,0x23); 


/第 二 路 灯亮 
send(0x02,0x23); 


/人 第 三 路 灯亮 
send(0x03,0x23); 


/人 第 四 路 灯亮 
send(0x04,0x23); 


W): 
NERA 


btnallcl=(ImageButton) findViewByld(R.id.btnclose); 
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btnallcl.setOnClickListener(new Button.OnClickListener()( 
@Override 


public void onClick(View v) 


{ 
/人 第 一 路 灯亮 
send(0x01 ,Oxff); 


/人 第 二 路 灯亮 
send(0x02,0xff); 


send(0x03,0xff); 
send(0x04,0xff); 


) 
» 
/产品 介绍 按钮 
imagebutton=(ImageButton) findViewByld(R.id.imageButton1); 
imagebutton.setOnClickListener(new Button.OnClickListener(){ 
@Override 


public void onClick(View v) 
{ 

Layoutinflater inflater = getLayoutinflater(); 
View layout = inflater.inflate(R.layout.dialog, 
(ViewGroup) findViewByld(R.id.dialog)); 


new AlertDialog.Builder(Firstpage.this) 
.setTitle("Introduce") 

.setView(layout) 
.setPositiveButton("Return", null) 
Il.setNegativeButton(" BGB", null) 
.Show(); 


n 


/人 第 一 子 节点 的 占 空 比 
radiogroup0=(RadioGroup)findViewByld(R.id.radioGroup2); 
radio1=(RadioButton)findViewByld(R.id.radio‘ 1); 
radio2-(RadioButton)findViewByld(R.id.radio12); 
radio3=(RadioButton)findViewByld(R.id.radio13); 
radio4=(RadioButton)findViewByld(R.id.radio1 4); 
radio5=(RadioButton)findViewByld(R.id.radio15); 
radio6=(RadioButton)findViewByld(R.id.radio16); 
radiogroup0.setOnCheckedChangeListener(new RadioGroup.OnCheckedChangeListener() { 


@Override 


public void onCheckedChanged(RadioGroup group, int checkedld) { 
11 TODO Auto-generated method stub 


switch (checkedld) 
{ 


case R.id.radio11: 
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AP*DisplayToast(" 灯 光亮 度 0%! ");*/ 
Toast.makeText(Firstpage.this, "第 一 路 灯光 亮度 为 0%! ", 
Toast.LENGTH_SHORT).show(); 


send(0x01 ,Oxff); 


} 
break; 
case R.id.radio12: 
II DisplayToast(" 灯 光亮 度 2096! "); 
Toast.makeText(Firstpage.this, "第 一 路 灯光 亮度 为 20%1! ", 
Toast.LENGTH_SHORT).show(); 


send(0x01,0xc8); 


H 
break; 
case R.id.radio13: 
/DisplayToast(" 灯 光亮 度 40%! "); 
Toast.makeText(Firstpage.this, "第 一 路 灯光 亮度 为 40%! ", 
ToastLENGTH_SHORT).show(); 


send(0x01,0x91); 


} 
break; 
case R.id.radio14: 
/DisplayToast(" 灯 光亮 度 60%! "y; 
Toast.makeText(Firstpage.this, "第 一 路 灯光 亮度 为 60%1! ", 
Toast.LENGTH SHORT).show(); 


send(0x01,0x5a); 


) 
break; 
case R.id.radio15: 
II DisplayToast("KT XZR 80%! "); 
Toast.makeText(Firstpage.this, "第 一 路 灯光 亮度 为 80%1! ", 
Toast.LENGTH_SHORT).show(); 


send(0x01 ,0x23); 


} 
break; 
default: 
11 DisplayToast(" 灯 光亮 度 10096! "); 
Toast.makeText(Firstpage.this, "第 一 路 灯光 亮度 为 100%1! ", 
Toast.LENGTH_SHORT).show(); 
{ 


send(0x01,0x00); 
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break; 


}); 

/| 第 二 子 节点 的 占 空 比 
radiogroup1=(RadioGroup)findViewByld(R.id.radioGroup3); 
radio11-(RadioButton)findViewByld(R.id.radio21 ); 
radio12-(RadioButton find ViewByld(R.id.radio22); 
radio13-(RadioButton find ViewByld(R.id.radio23); 
radio14-(RadioButton find ViewByld(R.id.radio24); 
radio15=(RadioButton )findViewByld(R.id.radio25); 
radio16=(RadioButton )findViewByld(R.id.radio26); 


radiogroup1.setOnCheckedChangeListener(new RadioGroup.OnCheckedChangeListener() { 


@Override 
public void onCheckedChanged(RadioGroup group, int checkedld) ( 
II TODO Auto-generated method stub 


switch (checkedld) 
d 
case R.id.radio21: 
l'DisplayToast("ATJE6RE 096! ");*/ 
Toast.makeText(Firstpage.this, "第 二 路 灯光 亮度 为 0%1! ", 
Toast.LENGTH_SHORT).show(); 


send(0x02,0xff); 


) 
break; 
case R.id.radio22: 
II DisplayToast(" 灯 光亮 度 2096! "); 
Toast.makeText(Firstpage.this, "第 二 路 灯光 亮度 为 20%!", 
Toast.LENGTH_SHORT).show(); 


send(0x02,0xc8); 


5 
break; 
case R.id.radio23: 
/DisplayToast(" 灯 光亮 度 40%1 "); 
Toast.makeText(Firstpage.this, "第 二 路 灯光 亮度 为 40%! ", 
Toast.LENGTH_SHORT).show(); 


send(0x02,0x91); 


} 
break; 
case R.id.radio24: 
/DisplayToast(" 灯 光亮 度 60%1 "); 
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Toast.makeText(Firstpage.this, "第 二 路 灯光 亮度 为 60%! ", 
Toast.LENGTH_SHORT).show(); 


send(0x02,0x5a); 


j 
break; 
case R.id.radio25: 
/DisplayToast(" 灯 光亮 度 80% ! "y; 
Toast.makeText(Firstpage.this, "第 二 路 灯光 亮度 为 80%! ", 
Toast.LENGTH SHORT).show(); 


{ 
send(0x02,0x23); 
} 
break; 
default: 
II DisplayToast(" 灯 光亮 度 100%! "); 
Toast.makeText(Firstpage.this, "第 二 路 灯光 亮度 为 100%1! ", 
Toast.LENGTH_SHORT).show(); 
{ 
send(0x02,0x00); 
} 
break; 
} 


} 
}); 


// 第 三 子 节点 的 占 空 比 

radiogroup2=(RadioGroup)findViewByld(R.id.radioGroup4); 
radio21=(RadioButtonjfindViewByld(R.id.radio31); 
radio22=(RadioButton)findViewByld(R.id.radio32); 
tadio23=(RadioButton)findViewByld(R.id.radio33); 
tadio24=(RadioButton)findViewByld(R.id.radio34); 
tadio25=(RadioButton)findViewByld(R.id.radio35); 
tadio26=(RadioButton)findViewByld(R.id.radio36); 
radiogroup2.setOnCheckedChangeListener(new RadioGroup.OnCheckedChangeListener() { 


@Override 
public void onCheckedChanged(RadioGroup group, int checkedld) { 
II TODO Auto-generated method stub 


switch (checkedld) 


{ 
case R.id.radio31: 
f'DisplayToast("XTJE ZE 096! ");*/ 
Toast.makeText(Firstpage.this, "第 三 路 灯光 亮度 为 0%1 ", 
Toast.LENGTH SHORT).show(); 
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send(0x03,0xff); 
) 
break; 
case R.id.radio32: 
/DisplayToast(" 灯 光亮 度 20% ! "y; 
Toast.makeText(Firstpage.this, "第 三 路 灯光 亮度 为 20%! ", 
Toast.LENGTH SHORT).show(); 
send(0x03,0xc8); 
) 
break; 
case R.id.radio33: 
/DisplayToast(" 灯 光亮 度 40% ! "); 
Toast.makeText(Firstpage.this, "第 三 路 灯光 亮度 为 40%! ", 
Toast.LENGTH_SHORT).show(); 
{ 
send(0x03,0x91); 
} 
break; 
case R.id.radio34: 
/DisplayToast(" 灯 光亮 度 60% ! "); 
Toast.makeText(Firstpage.this, "第 三 路 灯光 亮度 为 60%1! ", 
Toast.LENGTH_SHORT).show(); 
send(0x03,0x5a); 
} 
break; 
case R.id.radio35: 
/DisplayToast(" 灯 光亮 度 80%! "); 
Toast.makeText(Firstpage.this, "第 三 路 灯光 亮度 为 80%1! ", 
Toast.LENGTH_SHORT).show(); 
send(0x03,0x23); 
} 
break; 
default: 
II DisplayToast(" 灯 光亮 度 100%! "); 
Toast.makeText(Firstpage.this, "第 三 路 灯光 亮度 为 100%1 ", 
ToastLENGTH SHORT).show(); 
send(0x03,0x00); 
) 
break; 
H 
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} 
}; Imm 


/| 第 四 子 节点 的 占 空 比 

radiogroup3=(RadioGroupjfindViewByld(R.id.radioGroup5); 
radio31=(RadioButton)findViewByld(R.id.radio41); 
radio32=(RadioButton)findViewByld(R.id.radio42); 
radio33=(RadioButton)findViewByld(R.id.radio43); 

radio34- (RadioButton find ViewByld(R.id.radio44); 

radio35- (RadioButton find ViewByld(R.id.radio45); 

radio36- (RadioButton find ViewByld(R.id.radio46); 
radiogroup3.setOnCheckedChangeListener(new RadioGroup.OnCheckedChangeListener() ( 


@Override 
public void onCheckedChanged(RadioGroup group, int checkedld) ( 
11 TODO Auto-generated method stub 


Switch (checkedld) 
{ 
сазе R.id.radio41: 
ADisplayToast(" 灯 光亮 度 0%1! ");*/ 
Toast.makeText(Firstpage.this, "第 四 路 灯光 亮度 为 0%!"， 
Toast.LENGTH_SHORT).show(); 


{ 
send(0x04,0xff); 
) 
break; 
case R.id.radio42: 
II DisplayToast("KT HÆR 20%! "); 
Toast.makeText(Firstpage.this, "第 四 路 灯光 亮度 为 20%! ", 
Toast.LENGTH_SHORT).show(); 
{ 
send(0x04,0xc8); 
} 
break; 
case R.id.radio43: 
/DisplayToast(" 灯 光亮 度 40%1 "); 
Toast.makeText(Firstpage.this, "第 四 路 灯光 亮度 为 40%1! ", 
Toast.LENGTH_SHORT).show(); 
{ 
send(0x04,0x91); 
} 
break; 
case R.id.radio44: 
/DisplayToast(" 灯 光亮 度 6096! "); 
Toast.makeText(Firstpage.this, "第 四 路 灯光 亮度 为 60%1! ", 
Toast.LENGTH_SHORT).show(); 
{ 
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send(0x04,0x5a); 


} 
break; 
case R.id.radio45: 
II DisplayToast(" 灯 光亮 度 80%! "y; 
Toast.makeText(Firstpage.this, "第 四 路 灯光 亮度 为 80%! ", 
ToastLENGTH SHORT).show(); 
{ 
send(0x04,0x23); 
} 
break; 
default: 
II DisplayToast(" 灯 光亮 度 100%! "); 
Toast.makeText(Firstpage.this, "第 四 路 灯光 亮度 为 100%!"， 
Toast.LENGTH_SHORT).show(); 
{ 
send(0x04,0x00); 
) 
break; 
) 
} 


}); 


ibutton1 o-(ImageButton) findViewByld(R.id.imageButton2); 
ibutton1 o.setOnClickListener(new ClickEventKey()); 
ibutton1_c=(ImageButton) find ViewByld(R.id.imageButton3); 
ibutton1 c.setOnClickListener(new ClickEventKey()); 
ibutton2 o-(ImageButton) findViewByld(R.id.imageButton4); 
ibutton2 o.setOnClickListener(new ClickEventKey()); 
ibutton2 c-(ImageButton) findViewByld(R.id.imageButton5); 
ibutton2 c.setOnClickListener(new ClickEventKey()); 
ibutton3 o-(ImageButton) findViewByld(R.id.imageButton6); 
ibutton3 o.setOnClickListener(new ClickEventKey()); 
ibutton3 c-(ImageButton) findViewByld(R.id.imageButton7); 
ibutton3 c.setOnClickListener(new ClickEventKey()); 
ibutton4_o=(ImageButton) find ViewByld(R.id.imageButton8); 
ibutton4_o.setOnClickListener(new ClickEventKey()); 
ibutton4_c=(ImageButton) find ViewByld(R.id.imageButton9); 
ibutton4 c.setOnClickListener(new ClickEventKey()); 


) 


class ClickEventKey implements View.OnClickListener { 
@Override 
public void onClick(View v) { 
||  if(v--ibutton o) 
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e 


switch (v.getld()) 


{ 
case R.id.imageButton2: 
{ 
send(0x01,0x23); 
) 


break; 
case R.id.imageButton3: 


{ 

send(0x01,0xff); 
} 
break; 


case R.id.imageButton4: 
{ 


} 


send(0x02,0x23); 


break; 
case R.id.imageButton5: 


{ 


send(0x02,0xff); 
} 
break; 

case R.id.imageButton6: 
| 

send(0x03,0x23); 
} 
break; 

case R.id.imageButton7: 
{ 

send(0x03,0xff); 
) 
break; 

case R.id.imageButton8: 
{ 

send(0x04,0x23); 
} 
break; 

case R.id.imageButton9: 
{ 

send(0x04,0xff); 
} 
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break; 


private void send(int Room,int Grade){ 


try{ 


//String strpass="@@UP..."; 
byte[ ] byteone=new byte[8];//=strpass.getBytes("US-ASCII"); 
byteone[0]- (byte)Oxf5; 
byteone[1]=(byte)Ox5f; 
byteone[2]- (byte)0x00; 
byteone[3]-(byte)Room; 
byteone[4]- (byte)0x03; 
byteone[5]- (byte)0x00; 
byteone[6]=(byte)Grade; 
byteone[7]=(byte)0x06; 


//byte[ ] bytekai-strpass.getBytes("US-ASCII"); 
tmpOut = BluetoothMain.btSocket.getOutputStream(); 


tmpOut.write(byteone);) 
catch (IOException e) ( 
Log.e("BluetoothReadService", "temp sockets not created", e); 
} 
} 


} 
14.2.5 “控制 第 二 路 光线 的 亮度 


SRHSTUXENAR — 


编写 文件 Secondpagejava， 功 能 是 监听 用 户 在 第 二 路 调 光 单 选 按钮 列表 中 的 选择 值 ， 根 据 这 个 值 


来 控制 光线 的 亮度 。 文 件 Secondpage.java 的 具体 实现 代码 如 下 所 示 。 
public class Secondpage extends Activity { 
private ImageButton imagebutton; 


private ImageButton ibutton5 o,ibutton5 c,button6 o,ibutton6 c,button7 o, 


ibutton7 c,button8 o,button8 c; 
RadioGroup radiogroup0,radiogroup1 ,radiogroup2,radiogroup3; 
RadioButton radio1,radio2,radio3,radio4,radio5,radio6; 
RadioButton radio1 1 ,radio12,radio13,radio14,radio15,radio16; 
RadioButton radio21,radio22,radio23,radio24,radio25,radio26; 
RadioButton radio31 ,radio32,radio33 ,radio34, radio35,radio36; 
OutputStream tmpOut = null; 
@Override 
protected void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.second); 
imagebutton-(ImageButton) findViewByld(R.id.imageButton1 ); 
imagebutton.setOnClickListener(new Button.OnClickListener()( 
@Override 
public void onClick(View v) 


Android kB FF Sc 


{ 
Layoutinflater inflater = getLayoutInflater(); 


View layout = inflater.inflate(R.layout.dialog, 
(ViewGroup) findViewByld(R.id.dialog)); 


new AlertDialog.Builder(Secondpage.this) 
.setTitle("Introduce") 

.setView(layout) 
.setPositiveButton("Return", null) 

I|. setNegativeButton(" Boi", null) 

.show(); 


ny 


radiogroup0=(RadioGroup)findViewByld(R.id.radioGroup2); 
radio1-(RadioButton)findViewByld(R.id.radio1 1); 
radio2=(RadioButton)findViewByld(R.id.radio1 2); 
radio3=(RadioButton)findViewByld(R.id.radio13); 
radio4=(RadioButton)findViewByld(R.id.radio1 4); 
radio5-(RadioButton)findViewByld(R.id.radio15); 
radio6-(RadioButton)findViewByld(R.id.radio16); 
radiogroup0.setOnCheckedChangeListener(new RadioGroup.OnCheckedChangeListener() ( 


@Override 
public void onCheckedChanged(RadioGroup group, int checkedld) ( 
II TODO Auto-generated method stub 


Switch (checkedld) 
( 


case R.id.radio11: 
ADisplayToast(" 灯 光亮 度 0%1! ");*/ 
Toast.makeText(Secondpage.this, "第 五 路 灯光 亮度 为 0%! ", 
Toast.LENGTH_SHORT).show(); 
{ 


} 


send(0x05,0xff); 


break; 
case R.id.radio12: 
II DisplayToast(" 灯 光亮 度 2096! "); 
Toast.makeText(Secondpage.this, "第 五 路 灯光 亮度 为 20%!"， 
Toast.LENGTH SHORT).show(); 
d 


} 


send(0x05,0xc8); 
break; 
case R.id.radio13: 
/DisplayToast(" 灯 光亮 度 40% ! "); 
Toast.makeText(Secondpage.this, "第 五 路 灯光 亮度 为 40%! ", 
Toast.LENGTH_SHORT).show(); 
send(0x05,0x91); 


break; 
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case R.id.radio14: 
/DisplayToast(" 灯 光亮 度 60% ! "); 
Toast.makeText(Secondpage.this, "第 五 路 灯光 亮度 为 60%1! ", 
Toast.LENGTH_SHORT).show(); 
{ 
send(0x05,0x5a); 
} 
break; 
case R.id.radio15: 
/DisplayToast(" 灯 光亮 度 80% ! "y; 
Toast.makeText(Secondpage.this, "第 五 路 灯光 亮度 为 80%1! ", 
Toast.LENGTH_SHORT).show(); 


{ 
send(0x05,0x23); 
} 
break; 
default: 
/DisplayToast(" 灯 光亮 度 100%1! "); 
Toast.makeText(Secondpage.this, "第 一 路 灯光 亮度 为 100%1! ", 
ToastLENGTH SHORT).show(); 
{ 
send(0x05,0x00); 
} 
break; 
} 


} 


radiogroup1=(RadioGroup)findViewByld(R.id.radioGroup3); 

radio1 1=(RadioButton)findViewByld(R.id.radio21); 
tadio12=(RadioButton)findViewByld(R.id.radio22); 

tadio13=(RadioButton )findViewByld(R.id.radio23); 
tadio14=(RadioButton)findViewByld(R.id.radio24); 
tadio15=(RadioButton)findViewByld(R.id.radio25); 
tadio16=(RadioButton)findViewByld(R.id.radio26); 
radiogroup1.setOnCheckedChangeListener(new RadioGroup.OnCheckedChangeListener() ( 


@Override 
public void onCheckedChanged(RadioGroup group, int checkedld) { 
// TODO Auto-generated method stub 


switch (checkedld) 
{ 


case R.id.radio21: 
AP*DisplayToast(" 灯 光亮 度 0%! ");*/ 
Toast.makeText(Secondpage.this, "第 六 路 灯光 亮度 为 0%1! ", 
Toast.LENGTH_SHORT).show(); 


send(0x06,0xff); 
) 


break; 
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case R.id.radio22: 
II DisplayToast(" 灯 光亮 度 20%! "); 
Toast.makeText(Secondpage.this, "第 六 路 灯光 亮度 为 20%!"， 
Toast.LENGTH_SHORT).show(); 


send(0x06,0xc8); 
} 
break; 
case R.id.radio23: 
/DisplayToast(" 灯 光亮 度 40% ! "); 
Toast.makeText(Secondpage.this, "第 六 路 灯光 亮度 为 40%1! ", 
Toast.LENGTH_SHORT).show(); 


send(0x06,0x91); 
} 
break; 
case R.id.radio24: 
/DisplayToast(" 灯 光亮 度 60% ! "); 
Toast.makeText(Secondpage.this, "第 六 路 灯光 亮度 为 60%1! ", 
Toast.LENGTH SHORT).show(); 


send(0x06,0x5a); 
} 
break; 
case R.id.radio25: 
II DisplayToast("KT XÆ 80%! "); 
Toast.makeText(Secondpage.this, "第 六 路 灯光 亮度 为 80%1! ", 
Toast.LENGTH_SHORT).show(); 


( 
send(0x06,0x23); 
) 
break; 
default: 
II DisplayToast(" 灯 光亮 度 100% ! "); 
Toast.makeText(Secondpage.this, "第 六 路 灯光 亮度 为 100%1! ", 
Toast.LENGTH_SHORT).show(); 
{ 
send(0x06,0x00); 
} 
break; 
} 


} 
ys 


radiogroup2=(RadioGroup)findViewByld(R.id.radioGroup4); 
tadio21=(RadioButton)findViewByld(R .id.radio31 ); 
tadio22=(RadioButton)findViewByld(R .id.radio32); 
radio23=(RadioButton )findViewByld(R.id.radio33); 
radio24=(RadioButton)findViewByld(R.id.radio34); 
radio25=(RadioButton )findViewByld(R.id.radio35); 
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radio26=(RadioButton )findViewByld(R.id.radio36); 
radiogroup2.setOnCheckedChangeListener(new RadioGroup.OnCheckedChangeListener() { 


@Override 
public void onCheckedChanged(RadioGroup group, int checkedld) ( 
II TODO Auto-generated method stub 


switch (checkedld) 
{ 
case R.id.radio31: 
ADisplayToast(" 灯 光亮 度 0%! ");*/ 
Toast.makeText(Secondpage.this, "第 七 路 灯光 亮度 为 0%! ", 
Toast.LENGTH_ SHORT).show(); 


send(0x07 ,Oxff); 
} 
break; 
case R.id.radio32: 
/DisplayToast(" 灯 光亮 度 20%1! "); 
Toast.makeText(Secondpage.this, "第 七 路 灯光 亮度 为 20%!" 
Toast.LENGTH_SHORT).show(); 


send(0x07,0xc8); 
) 
break; 
case R.id.radio33: 
/DisplayToast(" 灯 光亮 度 40% ! "); 
Toast.makeText(Secondpage.this, "第 七 路 灯光 亮度 为 40%1! " 
Toast.LENGTH_SHORT).show(); 


send(0x07,0x91); 
} 
break; 
case R.id.radio34: 
/DisplayToast(" 灯 光亮 度 60% ! "); 
Toast.makeText(Secondpage.this, "第 七 路 灯光 亮度 为 60%1! ", 
Toast.LENGTH_SHORT).show/(); 


send(0x07,0x5a); 
} 
break; 
case R.id.radio35: 
II DisplayToast(" 灯 光亮 度 8096! "); 
Toast.makeText(Secondpage.this, "第 七 路 灯光 亮度 为 8096! ", 
Toast.LENGTH_SHORT).show(); 


ѕепа(0х07 ,0х23); 
} 
break; 
default: 
II DisplayToast("KT XZR 100%! "); 
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Toast.makeText(Secondpage.this, "第 七 路 灯光 亮度 为 100%!"， 
Toast.LENGTH SHORT).show(); 


send(0x07,0x00); 


break; 


} 
)y /第 四 路 


radiogroup3=(RadioGroup)findViewByld(R.id.radioGroup5); 

radio3 1=(RadioButton)findViewByld(R.id.radio41 ); 

radio32- (RadioButton find ViewByld(R.id.radio42); 

radio33- (RadioButton)find ViewByld(R.id.radio43); 

radio34- (RadioButton find ViewByld(R.id.radio44); 

radio35- (RadioButton find ViewByld(R.id.radio45); 

radio36- (RadioButton)find ViewByld(R.iid.radio46); 
radiogroup3.setOnCheckedChangeListener(new RadioGroup.OnCheckedChangeListener() ( 


@Override 
public void onCheckedChanged(RadioGroup group, int checkedld) { 
II TODO Auto-generated method stub 


Switch (checkedld) 
( 
case R.id.radio41: 
l'DisplayToast("ATJE6RE 096! ");*/ 
Toast.makeText(Secondpage.this, "第 八路 灯光 亮度 为 0%1! ", 
Toast.LENGTH_SHORT).show(); 


{ 
send(0x08,0xff); 
} 
break; 
case R.id.radio42: 
/DisplayToast(" 灯 光亮 度 20%1 "); 
Toast.makeText(Secondpage.this, "第 八路 灯光 亮度 为 20%! ", 
Toast.LENGTH_SHORT).show(); 
{ 
send(0x08,0xc8); 
} 
break; 
case R.id.radio43: 
/DisplayToast(" 灯 光亮 度 40%1 "); 
Toast.makeText(Secondpage.this, "第 八路 灯光 亮度 为 40%! ", 
Toast.LENGTH_SHORT).show(); 
{ 
send(0x08,0x91); 
} 
break; 
case R.id.radio44: 
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/DisplayToast(" 灯 光亮 度 60% ! "); 
Toast.makeText(Secondpage.this, "第 八路 灯光 亮度 为 60%1 ", 
ToastLENGTH_SHORT).show(); 


{ 
send(0x08,0x5a); 
} 
break; 
case R.id.radio45: 
/DisplayToast(" 灯 光亮 度 80% ! "y; 
Toast.makeText(Secondpage.this, "第 八路 灯光 亮度 为 80%1! ", 
Toast.LENGTH_SHORT).show(); 
send(0x08,0x23); 
} 
break; 
default: 
/DisplayToast(" 灯 光亮 度 100%1! "); 
Toast.makeText(Secondpage.this, "第 八路 灯光 亮度 为 100%1 ", 
Toast.LENGTH_SHORT).show(); 
{ 
send(0x08,0x00); 
} 
break; 
} 


} 
D 


ibutton5 o-(ImageButton) find ViewByld(R.id.imageButton2); 
ibutton5 o.setOnClickListener(new ClickEventKey()); 
ibutton5 c-(ImageButton) find ViewByld(R.id.imageButton3); 
ibutton5 c.setOnClickListener(new ClickEventKey()); 
ibutton6 o-(ImageButton) findViewByld(R.id.imageButton4); 
ibutton6 o.setOnClickListener(new ClickEventKey()); 
ibutton6_c=(ImageButton) find ViewByld(R.id.imageButton5); 
ibutton6 c.setOnClickListener(new ClickEventKey()); 
ibutton7 o-(ImageButton) findViewByld(R.id.imageButton6); 
ibutton7 o.setOnClickListener(new ClickEventKey()); 
ibutton7 c-(ImageButton) findViewByld(R.id.imageButton7); 
ibutton7 c.setOnClickListener(new ClickEventKey()); 
ibutton8 o-(ImageButton) findViewByld(R.id.imageButton8); 
ibutton8_o.setOnClickListener(new ClickEventKey()); 
ibutton8_c=(ImageButton) findViewByld(R.id.imageButton9); 
ibutton8_c.setOnClickListener(new ClickEventKey()); 
} 


class ClickEventKey implements View.OnClickListener { 
@Override 
public void onClick(View v) { 
|| (у == ibutton1_o) 
Switch (v.getld()) 
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{ 
case R.id.imageButton2: 
{ 

send(0x05,0x23); 

} 


break; 

case R.id.imageButton3: 
{ 
send(0x05,0xff); 

} 


break; 
case R.id.imageButton4: 
{ 

send(0x06,0x23); 

} 


break; 
case R.id.imageButton5: 
{ 


send(0x06,0xff); 
) 
break; 
case R.id.imageButton6: 
{ 
send(0x07,0x23); 
} 
break; 
case R.id.imageButton7: 
{ 
send(0x07,0xff); 
} 
break; 
case R.id.imageButton8: 
{ 
send(0x08,0x23); 
} 
break; 
case R.id.imageButton9: 
{ 
send(0x08,0xff); 
} 
break; 
} 
} 
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private void send(int Room,int Grade){ 


try{ 


//String strpass="@@UP..."; 
byte[ ] byteone=new byte[8];//-strpass.getBytes("US-ASCII"); 
byteone[0]-(byte)Oxf5; 
byteone[1]-(byte)Ox5f; 
byteone[2]- (byte)0x00; 
byteone[3]-(byte)Room; 
byteone[4]- (byte)0x03; 
byteone[5]=(byte)0x00; 
byteone[6]=(byte)Grade; 
byteone[7]- (byte )0x06; 


//byte[ ] bytekai-strpass.getBytes("US-ASCII"); 
tmpOut = BluetoothMain.btSocket.getOutputStream(); 
tmpOut.write(byteone);} 
catch (IOException e) { 
Log.e("BluetoothReadService", "temp sockets not created", e); 


} 
} 


到 此 为 止 ， 本 实例 的 主要 功能 模块 的 实现 过 程 介绍 完毕 。 本 实例 执行 后 的 效果 如 图 14-1 所 示 。 


14-1 执行 效果 
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当今 社会 人 们 的 生活 节奏 越 来 越 快 ， 随 着 硬件 移动 设备 越 来 越 先进 ， 人 们 对 时 间 的 观念 也 越 来 越 
高 。Android 作为 一 个 开源 的 智能 手机 系统 ， 具 备 了 六 钟 的 功能 。 和 传统 的 六 钟 相 比 ，Android FHL 
钟 更 加 灵活 、 方 便 、 准 时 。 在 本 章 的 内 容 中 ， 将 详细 讲解 在 Android 系统 中 开发 闹钟 系统 的 方法 ， 了 
解 大 型 闹钟 系统 的 具体 开发 流程 。 


15.1 m H AZ 


М 知识 点 讲解 光盘 :视频 \ 知 识 点 \ 第 15 章 \ 项 目 介绍 .avi 
本 章 播放 器 源码 保存 在 本 书 附带 光盘 中 的 “光盘 :\daima\15” 目 录 下 。 在 讲解 具体 编码 之 前 ， 先 简 
要 介绍 本 项 目的 产生 背景 和 项 目的 知识 ， 为 后 面 的 具体 编码 打 好 理论 基础 。 


15.1.1 系统 需求 分 析 


在 快 节奏 的 生活 中 ， 闹 钟 已 经 成 为 广大 人 群 不 可 缺少 的 物品 。Android 作为 一 款 强大 的 智能 手机 操 
作 系 统 ， 内 置 了 闭 钟 功能 ， 但 是 为 了 满足 人 们 的 更 高 要 求 ， 开 发 一 个 个 性 化 的 、 功 能 更 强大 的 闹钟 系 


统 势 在 必 行 。 
根据 市 场 调研 分 析 ， 一 个 典型 的 闹钟 系统 应 该 具备 如 下 所 示 的 功能 。 
(1) 添加 闹钟 
向 系统 中 添加 新 的 闹钟 ， 设 置 什么 时 候 闹 钟 会 提醒 我 们 ， 时 间 会 精确 到 几 点 几 分 。 
(2) 管理 闹钟 


为 了 提高 设置 闹钟 的 效率 ， 可 以 在 原 有 已 经 设置 的 闹钟 的 基础 上 管理 闹钟 。 具 体 来 说 ， 可 以 修改 
闹钟 的 具体 时 间 和 其 他 属性 〈 例 如 震动 、 铃 声 、 重 复 次 数 )。 

G) 删除 闹钟 

对 于 系统 中 不 需要 的 阐 钟 ， 可 以 及 时 删除 ， 节 约 系统 空间 。 

(4) 设置 其 他 属性 

在 设置 一 个 闹钟 时 ， 除 了 设置 一 个 具体 时 间 外 ， 还 可 以 设置 重复 次 数 、 闹 钟 开 关 、 在 哪 一 天 重复 、 
铃声 、 震 动 和 标记 。 


15.1.2 ”构成 模块 
根据 前 面 的 系统 需求 分 析 ， 可 以 规划 出 本 系统 的 构成 模块 如 图 15-1 所 示 。 
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一 一 一 > 添加 闹钟 


— 管理 闹钟 


闹钟 系统 


m ABR 


其 他 属性 设置 


图 15-1 系统 构成 模块 


152 ”系统 主 界面 


知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 15 章 \ 系 统 主 界面 .avi 
本 系统 的 主 界面 比较 简单 ， 执 行 后 会 在 屏幕 中 间 显示 当前 的 时 间 ， 并 显示 最 近 的 闹钟 和 天 气 情况 ， 
并 在 屏幕 下 方 显示 一 个 操作 导航 。 执 行 效果 如 图 15-2 所 示 。 


15-2 执行 效果 
在 本 节 的 内 容 中 ， 将 详细 讲解 主 界面 的 具体 实现 过 程 。 


152.1 布局 文件 


主 界面 的 核心 布局 功能 是 通过 文件 desk_clock_buttons.xml 实现 的 ， 主 要 实现 代码 如 下 所 示 。 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout_width="fill_ parent" 
android:layout_height="wrap_content" 


ë 
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android:layout_weight="0" 
> 
<ImageButton android:id="@+id/alarm_button" 
style="@style/ButtonStripLeft" 
android:layout height="wrap content" 
android:layout width="fill_parent" 
android:layout_weight=".25" 
android:src="@drawable/ic_clock strip alarm" 
android:contentDescription="@string/alarm_button_description" 
> 
«ImageButton android:id="@+id/gallery_button" 
style="@style/ButtonStripMiddle" 
android:layout_height="wrap_content" 
android:layout_width="fill_parent" 
android:layout_weight=".25" 
android:src="@drawable/ic_clock strip gallery" 
android:contentDescription-"(Q)string/gallery button description" 
> 
<ImageButton android:id="@+id/music_button" 
style="@style/ButtonStripMiddle" 
android:layout_height="wrap_content" 
android:layout_width="fill_ parent" 
android:layout_weight=".25" 
android:src="@drawable/ic_clock_strip_music" 
android:contentDescription="@string/music_button description" 
> 
«ImageButton android:id="@+id/home_button" 
style="@style/ButtonStripRight" 
android:layout height-"wrap content" 
android:layout_width="fill_ parent" 
android:layout weightz".25" 
android:src-"(drawable/ic clock strip home" 
android:contentDescription-"(Q)string/home button description" 
> 
</LinearLayout> 


本 系统 执行 后 ， 展 示 在 用 户 面前 的 便 是 图 15-2 所 示 的 界面。 
15.2.2 ”程序 文件 


系统 主 界面 的 程序 文件 是 DeskClock， 具 体 实现 流程 如 下 所 示 。 
(1) 定义 类 DeskClock， 并 定义 需要 常量 ， 具 体 实现 代码 如 下 所 示 。 
public class DeskClock extends Activity { 
private static final boolean DEBUG = false; 
private static final String LOG_TAG = "DeskClock"; 


// 午 夜 闹钟 动作 〈 可 以 更 新 日 期 显示 ) . 
private static final String ACTION_MIDNIGHT = "com.android.superdeskclock.MIDNIGHT"; 


@ 


gie semoae — 0 0 


I 设置 天 气 和 时 间 的 间隔 
private final long QUERY_WEATHER_DELAY = 60 * 60 * 1000; // 1 hr 


/为 闹钟 设置 广播 
private static final String DOCK SETTINGS ACTION = "com.android.settings.DOCK SETTINGS"; 


I| 设置 闹钟 延迟 设置 5 分钟 
private final long SCREEN_SAVER_TIMEOUT = 5* 60 * 1000; // 5 тїп 


/设置 屏幕 保护 程序 复位 延迟 
private final long SCREEN_SAVER_MOVE_DELAY = 60 * 1000; // 1 min 


/设置 在 屏幕 保护 模式 时 的 文本 和 图 形 的 颜色 
private final int SCREEN_SAVER_COLOR = OxFF308030; 
private final int SCREEN. SAVER. COLOR DIM = OxFF183018; 


I 设置 时 钟 显示 壁纸 与 黑色 图 层 之 间 的 不 透明 度 

private final float DIM_BEHIND_AMOUNT_NORMAL = 0.4f; 
I 高 对 比 变 暗 

private final float DIM_BEHIND_AMOUNT_DIMMED = 0.8f; 


/下 面 是 内 部 消息 ID 


private final int QUERY WEATHER DATA MSG = 0x1000; 
private final int UPDATE WEATHER DISPLAY MSG = 0x1001; 
private final int SCREEN_SAVER_TIMEOUT_MSG = 0x2000; 
private final int SCREEN SAVER MOVE MSG = 0x2001; 
/下 面 是 天 气 预报 查询 信息 设置 


private static final String СЕМЕ PACKAGE ID = "com.google.android.apps.genie.geniewidget"; 
private static final String WEATHER CONTENT AUTHORITY = GENIE_PACKAGE_ID + "weather"; 
private static final String WEATHER CONTENT PATH = "/weather/current"; 
private static final String] ] WEATHER CONTENT COLUMNS = new String[ ] ( 
"location", 
"timestamp", 
"temperature", 
"highTemperature", 
"lowTemperature", 
"iconUr", 
"iconResld", 
"description", 
} 
(2) 定义 函数 moveScreenSaverTo(0)， 功 能 是 移动 系统 的 屏幕 保护 程序 ， 其 中 参数 x 和 y 表 示 位 置 
坐标 。 函 数 moveScreenSaverTo() 的 具体 实现 代码 如 下 所 示 。 
private void moveScreenSaverTo(int x, int y) { 
if (ImScreenSaverMode) return; 


final View saver view = findViewByld(R.id.saver view); 
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Android kB TER Sc 


) 


DisplayMetrics metrics = new DisplayMetrics(); 
getWindowManager().getDefaultDisplay().getMetrics (metrics); 


if (x <0 || y < 0) { 
int myWidth = saver view.getMeasuredWidth(); 
int myHeight = saver_view.getMeasuredHeight(); 
x = (int)(mRNG.nextFloat()*(metrics.widthPixels - myWidth)); 
y = (int)(mRNG.nextFloat()*(metrics.heightPixels - myHeight)); 
} 


if (DEBUG) Log.d(LOG TAG, String.format("screen saver: %d: jumping to (%d,%d)", 
System.currentTimeMillis(), x, y)); 


saver_view.setLayoutParams(new AbsoluteLayout.LayoutParams( 
ViewGroup.LayoutParams.WRAP_CONTENT, 
ViewGroup.LayoutParams.WRAP_CONTENT, 
X, 


y» 


11 Synchronize our jumping so that it happens exactly on the second 
mHandy.sendEmptyMessageDelayed(SCREEN SAVER MOVE MSG, 
SCREEN SAVER MOVE DELAY + 
(1000 - (System.currentTimeMillis() % 1000))); 


(3) 定义 函数 setWakeLock(), 功能 是 设置 一 个 唤醒 锁 , 到 闹钟 时 间 时 会 唤醒 。 函数 setWakeLock() 


的 具体 实现 代码 如 下 所 示 。 


р 


Il 
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rivate void setWakeLock(boolean hold) ( 
if (DEBUG) Log.d(LOG TAG, (hold ? "hold" : " releas") + "ing wake lock"); 
Window win = getWindow(); 
WindowManager.LayoutParams winParams = win.getAttributes(); 
winParams.flags |= (WindowManager.LayoutParams.FLAG DISMISS KEYGUARD 
| WindowManager.LayoutParams.FLAG. SHOW WHEN LOCKED 
| WindowManager.LayoutParams.FLAG ALLOW LOCK WHILE SCREEN ON 
| WindowManager.LayoutParams.FLAG TURN SCREEN ON); 
if (hold) 
winParams.flags | WindowManager.LayoutParams.FLAG KEEP SCREEN ON; 
else 
winParams.flags &= (-WindowManager.LayoutParams.FLAG KEEP SCREEN ON); 
win.setAttributes(winParams); 


(4) 定义 函数 scheduleScreenSaver0， 功 能 是 设置 屏幕 保护 程序 的 时 间 表 ， 即 何 时 进入 屏保 状态 。 


定义 函数 restoreScreen(), 功能 是 恢复 到 正常 的 屏幕 模式 。 定义 函数 saveScreen()， 用 于 保存 当前 的 屏幕 


状态 ， 
p 


此 函数 能 够 处 理 OLED 模式 的 屏幕 保护 程序 。 上 述 3 个 函数 的 具体 实现 代码 如 下 所 示 。 
rivate void scheduleScreenSaver() { 
ll reschedule screen saver 
mHandy.removeMessages(SCREEN_SAVER_TIMEOUT_MSG); 
mHandy.sendMessageDelayed( 
Message.obtain(mHandy, SCREEN SAVER TIMEOUT MSG), 
SCREEN_SAVER_TIMEOUT); 


e 
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private void restoreScreen() { 


} 


if (ImScreenSaverMode) return; 

if (DEBUG) Log.d(LOG TAG, "restoreScreen"); 
mScreenSaverMode - false; 

initViews(); 

doDim(false); // restores previous dim mode 

II policy: update weather info when returning from screen saver 
if (mPluggedln) requestWeatherDataF etch(); 


scheduleScreenSaver(); 


refreshAll(); 


private void saveScreen() { 


if (mScreenSaverMode) return; 
if (DEBUG) Log.d(LOG_TAG, "saveScreen"); 


// 快 藏 起 来 的 X/Y 的 当前 日 期 

final View oldTimeDate = findViewByld(R.id.time_date); 
int oldLoc[ ] = new int[2]; 
oldTimeDate.getLocationOnScreen(oldLoc); 


mScreenSaverMode = true; 

Window win = getWindow(); 

WindowManager.LayoutParams winParams = win.getAttributes(); 
winParams.flags |= WindowManager.LayoutParams.FLAG_FULLSCREEN; 
win.setAttributes(winParams); 


// 在 切换 布局 屏幕 时 放弃 任何 内 部 聚焦 
final View focused = getCurrentFocus(); 
if (focused != null) focused.clearFocus(); 


setContentView(R.layout.desk clock saver); 
mTime = (DigitalClock) findViewByld(R.id.time); 


mbDate = (TextView) findViewByld(R.id.date); 
mNextAlarm = (TextView) findViewByld(R.id.nextAlarm); 


final int color = mDimmed ? SCREEN_SAVER_COLOR_DIM : SCREEN_SAVER_COLOR; 


((TextView)findViewByld(R.id.timeDisplay)).setTextColor(color); 
((TextView)findViewByld(R.id.am pm)).setTextColor(color); 
mbDate.setTextColor(color); 
mNextAlarm.setTextColor(color); 
mNextAlarm.setCompoundDrawablesWithintrinsicBounds( 
getResources().getDrawable(mDimmed 
? R.drawable.ic_lock_idle_alarm_saver_dim 
: R.drawable.ic_lock idle alarm saver), 
null, null, null); 
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mBatteryDisplay = 
mWeatherCurrentTemperature = 
mWeatherHighTemperature = 
mWeatherLowTemperature = 
mWeatherLocation = null; 
mWeatherlcon = null; 


refreshDate(); 
refreshAlarm(); 


moveScreenSaverTo(oldLoc[0], oldLoc[1]); 

} 

(5) 在 系统 的 主 界面 中 显示 了 当日 的 天 气 情 况 ， 此 功能 通过 如 下 函数 实现 。 

O 函数 requestWeatherDataFetch(): 功能 是 获取 天 气 数据 。 

口 函数 scheduleWeatherQueryDelayed(): 功能 是 处 理 天 气 查询 延迟 时 间 。 

Q 函数 queryWeatherData(): 功能 是 查询 天 气 数 据 。 

O 函数 updateWeatherDisplay(): 功能 是 在 界面 中 更 新 天 气 显示 。 

上 述 函 数 的 具体 实现 代码 如 下 所 示 。 

/| 告诉 widget 部 件 从 网 络 载 入 新 的 数据 

private void requestWeatherDataFetch() { 
if (DEBUG) Log.d(LOG_TAG, "forcing the Genie widget to update weather now..."); 
sendBroadcast(new Intent(ACTION GENIE REFRESH).putExtra("requestWeather", true)); 
II we expect the result to show up in our content observer 


} 


private boolean supportsWeather() { 
return (mGenieResources != null); 


} 


private void scheduleWeatherQueryDelayed(long delay) { 
II cancel any existing scheduled queries 
unscheduleWeatherQuery(); 
if (DEBUG) Log.d(LOG TAG, "scheduling weather fetch message for " + delay + "ms from now"); 
mHandy.sendEmptyMessageDelayed(QUERY WEATHER DATA MSG, delay); 

) 

private void unscheduleWeatherQuery() { 
mHandy.removeMessages(QUERY WEATHER DATA MSG); 


) 


private void queryWeatherData() ( 
II if we couldn't load the weather widget's resources, we simply 
ll assume it's not present on the device. 
if (mGenieResources == null) return; 


Uri queryUri 7 new Uri.Builder() 
.scheme(android.content.ContentResolver.SCHEME CONTENT) 
.authorit (WEATHER CONTENT AUTHORITY) 

.path( WEATHER CONTENT PATH) 
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.appendPath(new Long(System.currentTimeMillis()).toString()) 
.build(); 


if (DEBUG) Log.d(LOG_TAG, "querying genie: " + queryUri); 


Cursor cur; 
try { 
cur = getContentResolver().query( 
queryUri, 
WEATHER CONTENT COLUMNS, 
null, 
null, 
null); 
} catch (RuntimeException e) ( 
Log.e(LOG TAG, "Weather query failed", e); 
cur = null; 


} 


if (cur != null && cur.moveToFirst()) { 
if (DEBUG) { 
java.lang.StringBuilder sb = 
new java.lang.StringBuilder("Weather query result: {"); 
for(int i=0; i<cur.getColumnCount(); i++) { 
if (i>0) sb.append(", "); 
sb.append(cur.getColumnName(i)) 


-append("=") 
-append(cur.getString(i)); 
} 
sb.append("}"); 


Log.d(LOG TAG, sb.toString()); 
) 


mWeatherlconDrawable = mGenieResources.getDrawable(cur.getlnt( 
cur.getColumnIndexOrThrow("iconResld"))); 


mWeatherLocationString = cur.getString( 
cur.getColumniIndexOrThrow("location")); 


ll any of these may be NULL 

final int colTemp = cur.getColumnIndexOrThrow("temperature"); 
final int colHigh = cur.getColumnIndexOrThrow("highTemperature"); 
final int colLow = cur.getColumnIndexOrThrow("lowTemperature"); 


mWeatherCurrentTemperatureString = 
cur.isNull(colTemp) 
? Wu2014" 
: String.format("%d\u00b0", cur.getInt(colTemp)); 
mWeatherHighTemperatureString = 
cur.isNull(colHigh) 
? "\и2014" 
: String.format("%d\u00b0", cur.getlnt(colHigh)); 
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mWeatherLowTemperatureString = 
cur.isNull(colLow) 
? Wu2014" 
: String.format("%d\u00b0", cur.getlnt(colLow)); 
}else { 
Log.w(LOG_TAG, "No weather information available (cur=" 
+ cur +")"); 
mWeatherlconDrawable = null; 
mWeatherLocationString = getString(R.string.weather_fetch_failure); 
mWeatherCurrentTemperatureString = 
mWeatherHighTemperatureString = 
mWeatherLowTemperatureString = ""; 


} 

if (cur != null) { 
ll clean up cursor 
cur.close(); 

} 


mHandy.sendEmptyMessage(UPDATE_WEATHER_DISPLAY_MSG); 
} 


private void refreshWeather() { 
if (supportsWeather()) 
scheduleWeatherQueryDelayed(0); 
updateWeatherDisplay(); // in case we have it cached 
} 


private void updateWeatherDisplay() { 
if (mWeatherCurrentTemperature == null) return; 


mWeatherCurrentTemperature.setText(mWeatherCurrentTemperatureString); 
mWeatherHighTemperature.setText(mWeatherHighTemperatureString); 
mWeatherLowTemperature.setText(mWeatherLowTemperatureString ); 
mWeatherLocation.setText(mWeatherLocationString ); 
mWeatherlcon.setlmageDrawable(mWeatherlconDrawable); 


) 

(6) 在 系统 的 主 界面 中 显示 了 电量 信息 ， 此 功能 通过 如 下 函数 实现 。 
O 函数 handleBatteryUpdate(): 功能 是 更 新 显示 电量 信息 。 
O 函数 refreshBattery0: 功能 是 刷新 系统 的 当前 电量 。 
上 述 函数 的 具体 实现 代码 如 下 所 示 。 
private void handleBatteryUpdate(int plugStatus, int batteryLevel) { 

final boolean pluggedin = (plugStatus == BATTERY STATUS CHARGING || plugStatus == BATTERY_ 

STATUS_FULL); 


if (pluggedin != mPluggediIn) { 
setWakeLock(pluggedin); 


if (pluggedin) { 
II policy: update weather info when attaching to power 
requestWeatherDataFetch(); 
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} 

} 

if (pluggedin != mPluggedin || batteryLevel != mBatteryLevel) { 
mBatteryLevel = batteryLevel; 
mPluggedin = pluggedin; 


refreshBattery(); 
} 
} 
private void refreshBattery() { 
if (mBatteryDisplay == null) return; 
if (mPluggedIn /* || mBatteryLevel < LOW_BATTERY_THRESHOLD */) { 
mBatteryDisplay.setCompoundDrawablesWithIntrinsicBounds( 
0, 0, android.R.drawable.ic_lock_idle_charging, 0); 
mBatteryDisplay.setText( 
getString(R.string.battery_charging_level, mBatteryLevel)); 
mBatteryDisplay.setVisibility(View. VISIBLE); 
) else { 
mBatteryDisplay.setVisibility(View. INVISIBLE); 
} 
} 


(7) 为 了 及 时 更 新 系统 主 界面 ， 特 意 提供 了 如 下 刷新 函数 。 

O 函数 reffeshDate(0): 功能 是 更 新 显示 当前 的 时 间 。 

O 函数 refreshAlarm(): 功能 是 刷新 显示 系统 的 闹钟 。 

O 函数 reffeshAll0: 功能 是 分 别 调用 时 间 、 闹 钟 、 电 量 和 天 气 这 4 个 刷新 函数 。 

上 述 函数 的 具体 实现 代码 如 下 所 示 。 

private void refreshDate() { 
final Date now = new Date(); 
if (DEBUG) Log.d(LOG_TAG, "refreshing date..." + now); 
mDate.setText(DateFormat.format(mDateFormat, now)); 


} 


private void refreshAlarm() { 
if (mNextAlarm == null) return; 


String nextAlarm = Settings.System.getString(getContentResolver(), 
Settings.System.NEXT_ALARM_FORMATTED); 

if (ITextUtils.isEmpty(nextAlarm)) { 
mNextAlarm.setText(nextAlarm); 
//mNextAlarm.setCompoundDrawablesWithIntrinsicBounds( 
I android.R.drawable.ic_lock_idle_alarm, 0, 0, 0); 
mNextAlarm.setVisibility(View. VISIBLE); 

) else ( 
mNextAlarm.setVisibility(View.INVISIBLE); 

} 

} 


private void refreshAll() { 
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refreshDate(); 
refreshAlarm(); 
refreshBattery(); 
refreshWeather(); 

) 

(8) 定义 函数 doDim(), 设置 系统 进入 模糊 模式 显示 状态 。 在 系统 从 休眠 模式 恢复 到 正常 模式 时 ， 
之 间 的 模式 就 是 模糊 模式 。 函 数 doDim() 的 具体 实现 代码 如 下 所 示 。 

private void doDim(boolean fade){ 
View tintView = findViewByld(R.id.window_tint); 
if (tintView == null) return; 


Window win = getWindow(); 
WindowManager.LayoutParams winParams = win.getAttributes(); 


winParams.flags |= (WindowManager.LayoutParams.FLAG_LAYOUT_IN_SCREEN); 
winParams.flags |= (WindowManager.LayoutParams.FLAG LAYOUT NO LIMITS); 


// dim the wallpaper somewhat (how much is determined below) 
winParams.flags |= (WindowManager.LayoutParams.FLAG DIM BEHIND); 


if (mDimmed) ( 
winParams.flags |= WindowManager.LayoutParams.FLAG FULLSCREEN; 
winParams.dimAmount = DIM BEHIND AMOUNT DIMMED; 
Il winParams.buttonBrightness = WindowManager.LayoutParams.BRIGHTNESS OVERRIDE OFF; 


/ show the window tint 
tintView.startAnimation(AnimationUtils.loadAnimation(this, 

fade ? R.anim.dim 

: R.anim.dim instant)); 
)else( 
winParams.flags &= (-WindowManager.LayoutParams.FLAG FULLSCREEN); 
winParams.dimAmount = DIM BEHIND AMOUNT NORMAL; 
II winParams.buttonBrightness = WindowManager.LayoutParams.BRIGHTNESS_OVERRIDE_NONE; 


11 hide the window tint 
tintView.startAnimation(AnimationUtils.loadAnimation(this, 
fade ? R.anim.undim 
: R.anim.undim_instant)); 


} 


win.setAttributes(winParams); 
} 
(9) 为 了 保证 在 系统 主 界面 中 实现 不 同 模式 的 转换 ， 特 意 提供 了 如 下 模式 转换 函数 。 
O 函数 initViews0: 功能 是 初始 化 视图 界面 。 
O 函数 onPause(): 功能 是 暂停 当前 的 模式 转换 ， 关 闭 屏幕 保护 程序 ， 并 取消 任何 超时 操作 ， 但 取 
消 模糊 模式 除外 。 
口 函数 onStop0: 功能 是 停止 当前 的 模式 转换 。 
O 函数 onStart0: 功能 是 开启 系统 界面 ， 分 别 调用 对 应 的 函数 显示 时 间 、 闹 钟 、 电 量 和 天 气 。 


e 
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O 函数 onNewIntent0: 功能 是 开启 新 的 界面 视图 。 

О 函数 onConfigurationChanged(): 功能 是 根据 配置 改变 显示 视图 。 
上 述 函 数 的 具体 实现 代码 如 下 所 示 。 

public void onNewlntent(Intent newintent) { 


super.onNewintent(newintent); 
if (DEBUG) Log.d(LOG TAG, "onNewlntent with intent: " + newIntent); 


s 


II update our intent so that we can consult it to determine whether or 
/ not the most recent launch was via a dock event 
setintent(newlntent); 


} 


@Override 
public void onStart() ( 
super.onStart(); 


IntentFilter filter = new IntentFilter(); 
filter.addAction(Intent.ACTION DATE CHANGED); 
filter.addAction(Inten.ACTION BATTERY CHANGED); 

I filter.addAction(UiModeManager.ACTION EXIT DESK МОРЕ); 
filter.addAction(ACTION_MIDNIGHT); 
registerReceiver(mintentReceiver, filter); 


} 


@Override 
public void onStop() { 
super.onStop(); 


unregisterReceiver(mlntentReceiver); 


} 


@Override 
public void onResume() { 
super.onResume(); 
if (DEBUG) Log.d(LOG_TAG, "onResume with intent: " + getIntent()); 


II reload the date format in case the user has changed settings 
II recently 
mDateFormat = getString(R.string.full wday month day no year); 


II Listen for updates to weather data 

Uri weatherNotificationUri 2 new Uri.Builder() 
.scheme(android.content.ContentResolver.SCHEME CONTENT) 
.authorit (WEATHER CONTENT AUTHORITY) 
.path( WEATHER CONTENT PATH) 
-build(); 

getContentResolver().registerContentObserver( 
weatherNotificationUri, true, mContentObserver); 


11 Elaborate mechanism to find out when the day rolls over 
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Calendar today = Calendar.getInstance(); 
today.set(Calendar.HOUR OF DAY, 0); 
today.set(Calendar.MINUTE, 0); 
today.set(Calendar.SECOND, 0); 
today.add(Calendar.DATE, 1); 

long alarmTimeUTC = today.getTimelnMillis(); 


mMidnightIntent = PendingIntent.getBroadcast(this, 0, new Intent(ACTION MIDNIGHT), 0); 
AlarmManager am = (AlarmManager) getSystemService(Context.ALARM SERVICE); 
am.setRepeating(AlarmManager.RTC, alarmTimeUTC, AlarmManager.INTERVAL. DAY, mMidnightIntent); 
if (DEBUG) Log.d(LOG TAG, "set repeating midnight event at UTC: " 

+ alarmTimeUTC +" (" 

+ (alarmTimeUTC - System.currentTimeMillis()) 

+ " ms from now) repeating every " 

+ AlarmManager.INTERVAL. DAY + " with intent: " + mMidnightIntent); 


II lf we weren't previously visible but now we are, it's because we're 

II being started from another activity. So it's OK to un-dim. 

if (mTime != null && mTime.getWindowVisibility() != View.VISIBLE) ( 
mDimmed = false; 


} 


11 Adjust the display to reflect the currently chosen dim mode. 
doDim(false); 


restoreScreen(); // disable screen saver 
refreshAII(); // will schedule periodic weather fetch 


setWakeLock(mPluggedln); 
scheduleScreenSaver(); 


final boolean launchedFromDock 
= getintent().hasCategory(Intent. CATEGORY DESK DOCK); 


if (supportsWeather() && launchedFromDock && !mLaunchedFromDock) { 
II policy: fetch weather if launched via dock connection 
if (DEBUG) Log.d(LOG TAG, "Device now docked; forcing weather to refresh right now"); 
requestWeatherDataFetch(); 


} 

mLaunchedFromDock = launchedFromDock; 
} 
@Override 


public void onPause() { 


if (DEBUG) Log.d(LOG_TAG, "onPause"); 


II Turn off the screen saver and cancel any pending timeouts. 
11 (But don't un-dim.) 
mHandy.removeMessages(SCREEN SAVER TIMEOUT MSO); 
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restoreScreen(); 


11 Other things we don't want to be doing in the background. 

11 NB: we need to keep our broadcast receiver alive in case the dock 

İl is disconnected while the screen is off 
getContentResolver().unregisterContentObserver(mContentObserver); 


AlarmManager am = (AlarmManager) getSystemService(Context.ALARM SERVICE); 
am.cancel(mMidnightIntent); 
unscheduleWeatherQuery(); 


super.onPause(); 


} 


private void initViews() { 
/放弃 任何 在 当前 布局 中 的 切换 操作 
final View focused = getCurrentFocus(); 
if (focused != null) focused.clearFocus(); 


setContentView(R.layout.desk_clock); 


mTime = (DigitalClock) findViewByld(R.id.time); 
mDate = (TextView) findViewByld(R.id.date); 
mBatteryDisplay = (TextView) findViewByld(R.id.battery); 


mTime.getRootView().requestFocus(); 


mWeatherCurrentTemperature = (TextView) findViewByld(R.id.weather temperature); 
mWeatherHighTemperature = (TextView) findViewByld(R.id.weather high temperature); 
mWeatherLowTemperature = (TextView) findViewByld(R.id.weather low temperature); 
mWeatherLocation = (TextView) findViewByld(R.id.weather location); 

mWeatherlcon = (ImageView) findViewByld(R.id.weather icon); 


final View.OnClickListener alarmClickListener = new View.OnClickListener() ( 
public void onClick(View v) ( 
startActivity(new Intent(DeskClock.this, AlarmClock.class)); 
) 
Е 
public void onConfigurationChanged(Configuration newConfig) { 
super.onConfigurationChanged(newConfig); 


if (mScreenSaverMode) { 
moveScreenSaver(); 

}еіѕе{ 
initViews(); 
doDim(false); 
refreshAll(); 

} 


} 

(10) 在 主屏 幕 底部 生成 4 个 选项 ， 选 择 不 同 的 选项 后 会 实现 对 应 的 操作 ， 此 功能 的 实现 函数 如 下 。 
О 函数 onOptionsItemSelected(): 功能 是 根据 用 户 选择 的 选项 启动 对 应 的 视图 界面 。 
Q 函数 onCreateOptionsMenu(): 功能 是 创建 屏幕 底部 的 选项 菜单 。 
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O 函数 onCreate(0): 功能 是 创建 菜单 视图 。 
上 述 函 数 的 具体 实现 代码 如 下 所 示 。 
@Override 
public boolean onOptionsltemSelected(Menultem item) { 
Switch (item.getltemld()) { 
case R.id.menu_item_alarms: 
startActivity(new Intent(DeskClock.this, AlarmClock.class)); 
return true; 
case R.id.menu item add alarm: 
startActivity(new Intent(this, SetAlarm.class)); 
return true; 
case R.id.menu_item_dock_settings: 
startActivity(new Intent(DOCK_SETTINGS_ACTION)); 


return true; 
default: 
return false; 
} 
} 
@Override 


public boolean onCreateOptionsMenu(Menu menu) { 
Menulnflater inflater = getMenulnflater(); 
inflater.inflate(R.menu.desk_clock_menu, menu); 
return true; 


} 


@Override 
protected void onCreate(Bundle icicle) { 
super.onCreate(icicle); 


mRNG = new Random(); 


try { 

mGenieResources = getPackageManager().getResourcesForApplication(GENIE PACKAGE ID); 
} catch (PackageManager.NameNotFoundE xception e) { 

II no weather info available 

Log.w(LOG TAG, "Can't find "+СЕМЕ PACKAGE ID*". Weather forecast will not be available."); 
} 


initViews(); 
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GH 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 15 ФРА AR avi 
当 单 击 系统 主 界面 底部 导航 菜单 中 的 图 图 标 后 ， 会 进入 闹钟 列表 界面 。 执 行 效果 如 图 15-3 所 示 。 
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Add alarm 
12:56 лм 
12:56 лм 


12:56 am 


8:30 am 


8:52 м 


© 1:25. 
图 15-3 ”闹钟 列表 界面 执行 效果 
在 本 节 的 内 容 中 ， 将 详细 讲解 本 系统 闹钟 列表 模块 的 具体 实现 过 程 。 


15.3.1 设置 主 开 面 


图 15-3 所 示 的 是 闹钟 列表 界面 ， 在 顶部 显示 一 个 添加 按钮 图 标 。 在 中 间 显 示 了 一 个 两 列 列 表 ， 左 
侧 列表 显示 了 系统 中 的 所 有 闹钟 的 “是 否 可 用 ”开关 ， 在 右 侧 列表 显示 了 各 个 闹钟 的 具体 时 间 。 在 底 


部 显示 了 系统 的 当前 时 间 。 设 置 主 界面 的 布局 文件 是 alarm_clock.xml， 有 具体 实现 代码 如 下 所 示 。 
«LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/base_layout" 
android:layout_width="fill_ parent" 
android:layout height-"fill parent" 
android:orientation="vertical"> 


<LinearLayout android:id="@+id/add_alarm" 
android:clickable="true" 
android:focusable="true" 
android:background="@android:drawable/list_selector_background" 
android:layout_width="fill_ parent" 
android:layout height-"wrap content" 
android:orientation="horizontal"> 


<ImageView 
style="@style/alarm_list_left_column" 
android:duplicateParentState="true" 
android:gravity="center" 
android:scaleType-"center" 
android:src-"(Qdrawable/add alarm" /> 


<TextView 
android:duplicateParentState="true" 
android:layout_height="wrap_content" 
android:layout width-"wrap content" 
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android:layout gravity-"center vertical" 
android:textAppearance="?android:attr/textAppearanceLarge" 
android:textColor="?android:attr/textColorPrimary" 
android:text="@string/add_alarm" /> 


</LinearLayout> 


«ImageView 
android:layout_width="fill_ parent" 
android:layout height-"wrap content" 
android:scaleType-"fitX Y" 
android:gravity-"fill horizontal" 
android:src-"(oandroid:drawable/divider horizontal dark" /> 


«ListView 
android:id="@+id/alarms list" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout_weight="1" /> 


«LinearLayout 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:orientation-"horizontal" > 


<ImageButton android:id-"(Q)*id/desk clock button" 
style="@style/ButtonStripLeft" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:src="@drawable/ic_clock strip desk clock" 
android:contentDescription-"(g)string/desk clock button description"/» 


<com.android.superdeskclock.DigitalClock 
style="@style/ButtonStripRight" 
android:layout_width="fill_ parent" 
android:layout height-"fill parent"> 


«LinearLayout 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:baselineAligned="true"> 


<TextView android:id="@+id/timeDisplay" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:paddingRight-"6dip" 
android:textSize="48sp" 
android:textColor-"?android:attr/textColorPrimary" /> 


<TextView апагоіа:ід="@+ід/ат рт" 
android:layout_width="wrap_content" 
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android:layout_height="wrap_content" 
android:textAppearance="?android:attr/textAppearanceSmall" 
android:textStyle="bold" 
android:textColor="?android:attr/textColorPrimary" /> 
</LinearLayout> 
</com.android.superdeskclock.DigitalClock> 
</LinearLayout> 
</LinearLayout> 
设置 主 界面 的 对 应 程序 文件 是 AlarmClock.java， 具 体 实现 流程 如 下 。 
(1) 定 义 函数 bindView(), 根据 findViewByld 获取 系统 内 的 闹钟 , 并 将 获取 的 数据 绑 定 到 ListView 
控件 中 ， 以 列表 样式 显示 出 来 。 函 数 bindView() 的 具体 实现 代码 如 下 所 示 。 
public void bindView(View view, Context context, Cursor cursor) { 
final Alarm alarm = new Alarm(cursor); 


View indicator = view.findViewByld(R.id.indicator); 


11 Set the initial resource for the bar image. 
final ImageView barOnOff = (ImageView) indicator. findViewByld(R.id.bar_onoff); 
barOnOff.setimageResource(alarm.enabled ? R.drawable.ic_indicator_on : R.drawable.ic indicator off); 


II Set the initial state of the clock "checkbox" 
final CheckBox clockOnOff =(CheckBox) indicator.find ViewByld(R.id.clock onoff); 
clockOnOff.setChecked(alarm.enabled); 


/| 新 增 
this.context=context; 
11 Clicking outside the "checkbox" should also change the state. 
indicator.setOnClickListener(new OnClickListener() { 
public void onClick(View v) ( 
myDialog = ProgressDialog.show(AlarmTimeAdapter.this.context, "48 7s " "iR f" true); 
new Thread(){ 
public void run()( 
try 
sleep(800); 
}catch (Exception e)( 
e.printStackTrace(); 
)finally( 
// ERF ANER myDialog WR 
myDialog.dismiss(); 
) 
) 
}.start(); 
try { 
Thread.sleep(500); 
} catch (InterruptedException e) { 
e.printStackTrace(); 
} 
clockOnOff.toggle(); 
updatelndicatorAndAlarm(clockOnOff.isChecked(),barOnOff, alarm); 


) 
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ys 
DigitalClock digitalClock =(DigitalClock) view. findViewByld(R .id.digitalClock); 


II set the alarm text 

final Calendar c = Calendar.getInstance(); 
c.set(Calendar.HOUR OF DAY, alarm.hour); 
c.set(Calendar.MINUTE, alarm.minutes); 
digitalClock.updateTime(c); 
digitalClock.setTypeface(Typeface.DEFAULT); 


II Set the repeat text or leave it blank if it does not repeat. 

TextView daysOfWeekView = (TextView) digitalClock.findViewByld(R.id.daysOfWeek); 

final String daysOfWeekStr = alarm.daysOfWeek.toString(AlarmClock.this, false); 

if (daysOfWeekStr != null && daysOfWeekStr.length() != 0) { 
daysOfWeekView.setText(daysOfWeekStr); 
daysOfWeekView.setVisibility(View. VISIBLE); 

) else { 
daysOfWeekView.setVisibility(View.GONE); 

} 


II Display the label 
TextView labelView = (TextView) view.findViewByld(R.id. label); 
if (alarm.label != null && alarm.label.length() != 0) { 
labelView.setText(alarm.label); 
labelView.setVisibility (View. VISIBLE); 
}else { 
labelView.setVisibility(View.GONE); 
} 
} 
y: 
(2) 定义 函数 onContextItemSelected(0)， 功 能 是 根据 用 户 选择 确认 列表 中 的 闹钟 是 否 处 于 可 用 状 
态 , 并 根据 用 户 选择 来 到 不 同 状态 的 处 理 界面 。 函数 onContextItemSelected() 的 具体 实现 代码 如 下 所 示 。 
@Override 
public boolean onContextltemSelected(final Menultem item) { 
final AdapterContextMenulnfo info = (AdapterContextMenulnfo) item.getMenulnfo(); 
final int id = (int) info.id; 
switch (item.getltemld()) { 
case R.id.delete_alarm: 
// 确 认 闲 钟 已 被 删除 
new AlertDialog.Builder(this) 
.setTitle(getString(R.string.delete alarm)) 
.setMessage(getString(R.string.delete alarm confirm)) 
.setPositiveButton(android.R.string.ok, 
new DialogInterface.OnClickListener() f 
public void onClick(DialogInterface d, int w) ( 
Alarms.deleteAlarm(AlarmClock.this, id); 
} 


» 
-setNegativeButton(android.R.string.cancel, null) 
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.Show(); 
return true; 


case R.id.enable_alarm: 
final Cursor c = (Cursor) mAlarmsList.getAdapter().getltem(info. position); 
final Alarm alarm = new Alarm(c); 
/修改 
Alarms.enableAlarm(this, alarm.id, !alarm.enabled); 
if (lalarm.enabled) { 
SetAlarm.popAlarmSetToast(this, alarm.hour, alarm.minutes, alarm.daysOfWeek); 
} 


return true; 


case R.id.edit_alarm: 
Intent intent = new Intent(this, SetAlarm.class); 
intent.putExtra(Alarms.ALARM ID, id); 
startActivity(intent); 
return true; 


default: 
break; 

} 

return super.onContextltemSelected(item); 
} 

(3) 定义 函数 onCreate()， 功 能 是 显示 当前 的 界面 。 定 义 函 数 updateLayout()， 根 据 用 户 选择 更 新 
显示 为 对 应 的 界面 。 有 具体 实现 代码 如 下 所 示 。 

@Override 
protected void onCreate(Bundle icicle) { 

super.onCreate(icicle); 


mFactory = LayoutlInflater.from(this); 
mPrefs = getSharedPreferences(PREFERENCES, 0); 
mCursor = Alarms.getAlarmsCursor(getContentResolver()); 


updateLayout(); 
} 


private void updateLayout() { 
setContentView(R.layout.alarm_clock); 
mAlarmsList = (ListView) findViewByld(R.id.alarms list); 
AlarmTimeAdapter adapter = new AlarmTimeAdapter(this, mCursor); 
mAlarmsList.setAdapter(adapter); 
mAlarmsList.setVerticalScrollBarEnabled(true); 
mAlarmsList.setOnltemClickListener(this); 
mAlarmsList.setOnCreateContextMenuListener(this); 


View addAlarm = findViewByld(R.id.add_alarm); 
addAlarm.setOnClickListener(new View.OnClickListener() { 
public void onClick(View v) { 
addNewAlarm(); 
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} 
ys 
| 当 在 屏幕 中 聚焦 时 选择 这 个 选项 


addAlarm.setOnFocusChangeListener(new View.OnFocusChangeListener() { 
public void onFocusChange(View v, boolean hasFocus) { 
v.setSelected(hasFocus); 
} 
D 


ImageButton deskClock = 
(ImageButton) findViewByld(R.id.desk clock button); 
deskClock.setOnClickListener(new View.OnClickListener() { 
public void onClick(View v) { 
startActivity(new Intent(AlarmClock.this, DeskClock.class)); 
} 
y); 
) 
(4) 定义 函数 addNewAlarm(), WEES ASIN FHA. TE LPR A onCreateContextMenu(), 2) 
能 是 创建 一 个 上 下 文 菜单 。 具 体 实现 代码 如 下 所 示 。 
private void addNewAlarm() ( 
startActivity(new Intent(this, SetAlarm.class)); 
} 


@Override 

protected void onDestroy() ( 
super.onDestroy(); 
ToastMaster.cancelToast(); 
mCursor.deactivate(); 


) 


@Override 
public void onCreateContextMenu(ContextMenu menu, View view, 
ContextMenulnfo menulnfo) { 
/从 xml 文件 创建 菜单 


getMenulnflater().inflate(R.menu.context_menu, menu); 


// 使 用 当前 项 目 创建 自 定义 视图 的 页 眉 
final AdapterContextMenulnfo info = (AdapterContextMenulnfo) menulnfo; 
final Cursor c= 

(Cursor) mAlarmsList.getAdapter().getltem((int) info.position); 
final Alarm alarm = new Alarm(c); 


// 构 建 日 历 计 算 时 间 

final Calendar cal = Calendar.getinstance(); 
cal.set(Calendar.HOUR OF DAY, alarm.hour); 
cal.set(Calendar.MINUTE, alarm.minutes); 
final String time = Alarms.formatTime(this, cal); 


// 设 置 自 定义 视图 和 每 个 程序 的 文本 
final View v = mFactory.inflate(R.layout.context menu header, null); 
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TextView textView = (TextView) v.findViewByld(R.id.header_time); 
textView.setText(time); 

textView = (TextView) v.findViewByld(R.id.header_label); 
textView.setText(alarm.label); 


// 在 菜单 上 设置 自 定义 视图 
menu.setHeaderView(v); 
II Change the text based on the state of the alarm. 
if (alarm.enabled) ( 
menu.findltem(R.id.enable alarm).setTitle(R.string.disable alarm); 
} 
} 
当 按 下 MENU 手机 按键 后 会 在 屏幕 底部 弹出 这 个 菜单 项 ， 如 图 15-4 所 示 。 


Alarms: 


© Addalarm 


£ 1256. 


12:56 u 


12:56 am 


8:30 am 


8:52 am 


图 15-4 屏幕 底部 的 上 下 文 菜单 项 
在 图 15-4 所 示 的 菜单 项 中 ， 包 含 了 六 钟 设置 、 添 加 闹钟 和 闸 钟 主 界面 3 个 选项 。 


(5) 定义 函数 onOptionsItemSelected()， 功 能 是 根据 用 户 在 函数 onCreateContextMenu()4 
上 下 文 菜单 上 选择 的 项 ， 来 到 不 同 的 界面 。 具 体 实现 代码 如 下 所 示 。 
@Override 
public boolean onOptionsltemSelected(Menultem item) { 
switch (item.getltemld()) { 
case R.id.menu_item_settings: 
startActivity(new Intent(this, SettingsActivity.class)); 
return true; 
case R.id.menu_item_desk_clock: 
startActivity(new Intent(this, DeskClock.class)); 
return true; 
case R.id.menu_item_add_alarm: 
addNewAlarm(); 
return true; 
default: 
break; 


} 


return super.onOptionsltemSelected(item); 
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} 


@Override 

public boolean onCreateOptionsMenu(Menu menu) { 
getMenulnflater().inflate(R.menu.alarm list menu, menu); 
return super.onCreateOptionsMenu(menu); 


} 


public void onltemClick(AdapterView parent, View v, int pos, long id) { 
Intent intent = new Intent(this, SetAlarm.class); 
intent.putExtra(Alarms.ALARM ID, (int) id); 
startActivity(intent); 

} 


15.3.2 ”设置 闹钟 界面 


当 在 图 15-3 所 示 的 闹钟 列表 界面 中 选择 一 个 闹钟 时 ， 会 来 到 设置 闹钟 界面 。 在 此 界面 中 可 以 设置 被 
选中 闹钟 的 选项 ， 例 如 开关 、 时 间 、 重 复 次 数 、 铃 声 和 震动 等 。 设 置 闹钟 界面 的 执行 效果 如 图 15-5 所 示 。 


Setalarm 


Turn alarm on 


Time 


Times 


Repeat 


Ringtone 


Vibrate 


Í bo 


图 15-5 设置 闹钟 界面 的 执行 效果 


图 15-5 所 示 的 界面 效果 是 由 文件 set_alarm.xml 实现 布局 的 ， 具 体 实现 代码 如 下 所 示 。 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:layout_width="fill_ parent" 
android:layout height-"fill parent" 
android:orientation="vertical"> 
«ListView android:id="@android:id/list" 
android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
android:layout_weight="1" 
android:drawSelectorOnTop="false"/> 
<LinearLayout 
android:layout_width="fill_ parent" 
android:layout height-"wrap content" 
android:orientation-"horizontal" 
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style="@android:style/ButtonBar"> 

«Button android:id="@+id/alarm_save" 
android:focusable="true" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:layout weight-"1" 
android:text="@string/done"/> 

<Button android:id="@+id/alarm_revert" 
android:focusable="true" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:layout_weight="1" 
android:text="@string/revert"/> 

«Button android:id="@+id/alarm_delete" 
android:focusable="true" 
android:layout_width="fill_ parent" 
android:layout_height="fill_parent" 
android:layout_weight="1" 
android:text="@string/delete"/> 

</LinearLayout> 
</LinearLayout> 


设置 闹钟 界面 的 程序 文件 是 SetAlarmjava， 有 具体 实现 流程 如 下 所 示 。 
(1) 定义 继承 于 PreferenceActivity 的 类 SetAlarm， 用 于 管理 系统 中 的 每 一 个 闹钟 。 具 体 实现 代码 
如 下 所 示 。 
public class SetAlarm extends PreferenceActivity 


implements TimePickerDialog.OnTimeSetListener, 
Preference.OnPreferenceChangeListener { 


private EditTextPreference mLabel; 


// 新 增 
private EditTextPreference times; 
private EditTextPreference interval; 


private CheckBoxPreference mEnabledPref; 
private Preference mTimePref; 

private SetBellPreference mAlarmPref; 
private RadioButton RadioButton; 

private CheckBoxPreference mVibratePref; 
private RepeatPreference mRepeatPref; 
private Menultem mTestAlarmltem; 


private int mid; 

private int mHour; 

private int mMinutes; 

private boolean mTimePickerCancelled; 
private Alarm — mOriginalAlarm; 


(2) 定义 函数 onCreate 以 创建 此 界面 的 显示 视图 ， 加 载 显示 系统 中 原来 对 这 个 闹钟 的 设置 。 函 数 
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onCreate() 的 具体 实现 代码 如 下 所 示 。 

p 
* 设 置 一 个 Alarm 闹钟 ， 通 过 外 部 Alarms.ALARM ID 实现 
* 诸 如 其 他 Activity 之 类 的 Alarm 对 象 
Ч! 

@Override 

protected void onCreate(Bundle icicle) { 

super.onCreate(icicle); 


11 Override the default content view. 
setContentView(R.layout.set alarm); 
addPreferencesFromResource(R.xml.alarm prefs); 
// 新 增 
times = (EditTextPreference) findPreference("times"); 
times.setOnPreferenceChangeListener( 
new Preference.OnPreferenceChangeListener() { 
public boolean onPreferenceChange(Preference p, 
Object newValue) { 
String val = (String) newValue; 
11 Set the summary based on the new label. 
p.setSummary (val); 
if (val != null && !val.equals(times.getText())) { 
II Call through to the generic listener. 
return SetAlarm.this.onPreferenceChange(p, 
newValue); 
} 
return true; 


} 


}); 
I| 检索 值 ， 获 取 每 一 个 偏好 值 
mLabel = (EditTextPreference) findPreference("label"); 
mLabel.setOnPreferenceChangeListener( 
new Preference.OnPreferenceChangeListener() { 
public boolean onPreferenceChange(Preference p, 
Object newValue) { 
String val = (String) newValue; 
11 Set the summary based on the new label 
p.setSummary(val); 
if (val != null && !val.equals(mLabel.getText())) { 
II Call through to the generic listener 
return SetAlarm.this.onPreferenceChange(p, 
newValue); 
} 
return true; 
} 
ys 
mEnabledPref = (CheckBoxPreference) findPreference("enabled"); 
mEnabledPref.setOnPreferenceChangeListener( 
new Preference.OnPreferenceChangeListener() { 
public boolean onPreferenceChange(Preference p, 


e 


Object newValue) { 
II Pop a toast when enabling alarms 
if (ImEnabledPref.isChecked()) { 
popAlarmSetToast(SetAlarm.this, mHour, mMinutes, 
mRepeatPref.getDaysOfWeek()); 
} 
return SetAlarm.this.onPreferenceChange(p, newValue); 
} 
}); 
mTimePref = findPreference("time"); 
mAlarmPref = (SetBellPreference) findPreference("alarm"); 
mAlarmPref.setOnPreferenceChangeListener(this); 
mVibratePref = (CheckBoxPreference) findPreference("vibrate"); 
mVibratePref.setOnPreferenceChangeListener(this); 
mRepeatPref = (RepeatPreference) findPreference("setRepeat"); 
mRepeatPref.setOnPreferenceChangeListener(this); 


Intent i = getintent(); 
mld = i.getlntExtra(Alarms.ALARM ID, -1); 
if (Log. LOGV) { 

Log.v("In SetAlarm, alarm id = "+ mld); 
} 


Alarm alarm = null; 
if (mld == -1) { 
// 没 有 闹钟 则 新 建 一 个 
alarm = new А!агт(); 
) else ( 
上 从 数据 库 中 显示 这 个 闹钟 的 详细 信息 */ 
alarm = Alarms.getAlarm(getContentResolver(), mld); 
II Bad alarm, bail to avoid a NPE. 
if (alarm == null) { 
finish(); 
return; 
} 
} 


mOriginalAlarm = alarm; 
updatePrefs(mOriginalAlarm); 


// 选 中 时 高 亮 显示 
getListView().setltemsCanFocus(true); 


/| 给 每 个 按钮 附加 操作 
Button b = (Button) findViewByld(R.id.alarm_save); 
b.setOnClickListener(new View.OnClickListener() { 
public void onClick(View v) { 
saveAlarm(); 
finish(); 


}) 
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final Button revert = (Button) findViewByld(R.id.alarm_revert); 
revert.setEnabled(false); 
revert.setOnClickListener(new View.OnClickListener() { 
public void onClick(View v) { 

int newld = mld; 

updatePrefs(mOriginalAlarm); 

11 "Revert" on a newly created alarm should delete it 

if (mOriginalAlarm.id == -1) { 

Alarms.deleteAlarm(SetAlarm.this, newld); 


) else { 
saveAlarm(); 
) 
revert.setEnabled(false); 
} 
}); 
b = (Button) findViewByld(R.id.alarm_ delete); 
if (mld == -1) ( 
b.setEnabled (false); 
) else { 
b.setOnClickListener(new View.OnClickListener() { 
public void onClick(View v) { 
deleteAlarm(); 
} 
}); 
} 
// 如 果 改 变 了 时 间 ， 则 弹出 时 间 选 择 器 
if (mld == -1)( 
11 Assume the user hit cancel 
mTimePickerCancelled = true; 
showTimePicker(); 
} 


} 
private static final Handler sHandler = new Handler(); 
(3) 定义 函数 onPreferenceChange() 以 处 理 偏好 变化 ， 具 体 实现 代码 如 下 所 示 。 
public boolean onPreferenceChange(final Preference р, Object newValue) { 
/定义 异步 方法 保存 偏好 值 的 更 改 
sHandler.post(new Runnable() { 
public void run() { 
/| 编辑 可 设置 的 偏好 
if (p != mEnabledPref) { 
mEnabledPref.setChecked(true); 
b 
saveAlarmAndEnableRevert(); 
) 
ys 
return true; 
} 
(4) 定义 函数 updatePrefs0 以 更 新 对 这 个 曾 钟 的 设置 ， 具 体 实现 代码 如 下 所 示 。 
private void updatePrefs(Alarm alarm) { 


e 
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mid = alarm.id; 
mEnabledPref.setChecked(alarm.enabled); 
mLabel.setText(alarm.label); 
mLabel.setSummary(alarm.label); 

mHour = alarm.hour; 

mMinutes = alarm.minutes; 
mRepeatPref.setDaysOfWeek(alarm.daysOfWeek); 
mVibratePref.setChecked(alarm.vibrate); 

II Give the alert uri to the preference 
mAlarmPref.setAlert(alarm.alert); 


/新 增 
times.setText(""+alarm.times); 
times.setSummary(""+alarm.times); 


updateTime(); 
} 
(5) 定义 函数 onTimeSet() 以 设置 新 闻 钟 的 时 间 ， 定 义 函 数 upTimeSet() E KoA PRI) uj, „А. 
体 实现 代码 如 下 所 示 。 
public void onTimeSet(TimePicker view, int hourOfDay, int minute) { 
11 onTimeSet is called when the user clicks "Set" 
mTimePickerCancelled = false; 
mHour = hourOfDay; 
mMinutes 7 minute; 
updateTime(); 
11 \f the time has been changed, enable the alarm. 
mEnabledPref.setChecked(true); 
11 Save the alarm and pop a toast. 
popAlarmSetToast(this, saveAlarmAndEnableRevert()); 
} 
private void updateTime() { 
if (Log.LOGV) { 
Log.v("updateTime " + mld); 
} 
mTimePref.setSummary(Alarms.formatTime(this, mHour, mMinutes, 
mRepeatPref.getDaysOfWeek())); 
} 
(6) 定义 函数 saveAlarmAndEnableRevert() 以 保存 闹钟 ， 并 设置 Revert 按钮 不 可 用 。 有 具体 实现 代 
码 如 下 所 示 。 
private long saveAlarmAndEnableRevert() { 
II Enable "Revert" to go back to the original Alarm 
final Button revert = (Button) findViewByld(R.id.alarm_revert); 
revert.setEnabled(true); 
return saveAlarm(); 
} 
(7) 定义 函数 saveAlarm() 以 保存 对 当前 闹钟 的 设置 ， 具 体 实现 代码 如 下 所 示 。 
private long saveAlarm(){ 
Alarm alarm = new Alarm(); 
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alarm.id = mld; 

alarm.enabled = mEnabledPref.isChecked(); 
alarm.hour = mHour; 

alarm.minutes = mMinutes; 

alarm.daysOfWeek = mRepeatPref.getDaysOfWeek(); 
alarm.vibrate = mVibratePref.isChecked(); 

alarm.label = mLabel.getText(); 

alarm.alert = mAlarmPref.getAlert(); 


/新 增 

String timesText=times.getText(); 
alarm.times=Integer.parselnt(timesText==null||"".equals(times Text)?"0":timesText); 
alarm.interval=0; 


long time; 
if (alarm.id == -1) { 
time = Alarms.addAlarm(this, alarm); 
11 addAlarm populates the alarm with the new id. Update mld so that 
II changes to other preferences update the new alarm 
mld = alarm.id; 
) else { 
time = Alarms.setAlarm(this, alarm); 
} 
return time; 
} 
(8) 定义 函数 deleteAlarm() 以 删除 当前 闹钟 ， 在 单 击 屏幕 底部 的 Delete 按钮 时 被 触发 。 函 数 
deleteAlarm() 的 具体 实现 代码 如 下 所 示 。 
private void deleteAlarm() { 
new AlertDialog.Builder(this) 
.setTitle(getString(R.string.delete alarm)) 
.setMessage(getString(R.string.delete alarm confirm)) 
.setPositiveButton(android.R.string.ok, 
new Dialoglnterface.OnClickListener() { 
public void onClick(DialogInterface d, int w) { 
Alarms.deleteAlarm(SetAlarm.this, mld); 
finish(); 
} 
р 
.setNegativeButton(android.R.string.cancel, null) 
.Show(); 
} 
(9) 定义 函数 popAlarmSetToast(), 功能 是 当 设 置 完毕 后 单 击 屏 幕 底部 的 Done 按钮 后 显示 一 个 六 
钟 设置 提醒 信息 ， 如 图 15-6 所 示 。 


Vihrato 


set for 21 hours and 47 


now 


图 15-6 提醒 信息 效果 
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函数 popAlarmSetToast() 的 具体 实现 代码 如 下 所 示 。 
static void popAlarmSetToast(Context context, int hour, int minute, 


} 


Alarm.DaysOfWeek daysOfWeek) { 
popAlarmSetToast(context, 
Alarms.calculateAlarm(hour, minute, daysOfWeek) 
.getTimelnMillis()); 


private static void popAlarmSetToast(Context context, long timelnMillis) { 


} 


String toastText = formatToast(context, timelnMillis); 

Toast toast = Toast.makeText(context, toastText, Toast.LENGTH LONG); 
ToastMaster.setToast(toast); 

toast.show(); 


(10) 定义 函数 formatToast()， 功 能 是 设置 提醒 信息 的 内 容 ， 有 具体 实现 代码 如 下 所 示 。 


static String formatToast(Context context, long timelnMillis) { 


long delta = timelnMillis - System.currentTimeMillis(); 
long hours - delta / (1000 * 60 * 60); 

long minutes = delta / (1000 * 60) % 60; 

long days = hours / 24; 

hours = hours % 24; 


String daySeq = (days == 0) ? " : 
(days == 1) ? context.getString(R.string.day) : 
context.getString(R.string.days, Long.toString(days)); 


String minSeq = (minutes == 0) ? "" : 
(minutes == 1) ? context.getString(R.string.minute) : 
context.getString(R.string.minutes, Long.toString(minutes)); 


String hourSeq = (hours == 0) ? " : 
(hours == 1) ? context.getString(R.string.hour) : 
context.getString(R.string.hours, Long.toString(hours)); 


boolean dispDays = days > 0; 
boolean dispHour = hours > 0; 
boolean dispMinute = minutes > 0; 


int index = (dispDays ? 1 : 0) | 
(dispHour ? 2 : 0) | 
(dispMinute ? 4 : 0); 


String[ ] formats = context.getResources().getStringArray(R.array.alarm set); 
return String.format(formats[index], daySeq, hourSeq, minSeq); 


public void setInterval(EditTextPreference interval) ( 
this.interval = interval; 


) 
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15.3.3 ”闹钟 提醒 模块 


内 容 
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在 本 实例 中 ， 涉 及 了 多 处 闹钟 提醒 模块 ， 例 如 闹钟 到 时 响起 时 的 提醒 、 闹 钟 全 屏 提 醒 。 在 本 节 的 
中 ， 将 详细 讲解 闹钟 提醒 模块 的 具体 实现 过 程 。 
СТ) 界面 布局 文件 是 alarm alert.xml， 具 体 实现 代码 如 下 所 示 。 
<LinearLayout 
xmins:android="http://schemas.android.com/apk/res/android" 
android:layout_width="fill_ parent" 
android:layout_height="fill_ parent" 
android:gravity="center"> 
<LinearLayout 
android:layout_width="wrap_content" 
android:layout height="wrap content" 
android:layout gravity-"center" 
android:gravity-"center horizontal" 
android:background="@drawable/dialog" 
android:orientation="vertical"> 
<TextView android:id="@+id/alertTitle" 
style="?android:attr/textAppearanceLarge" 
android:padding="5dip" 
android:singleLine="true" 
android:ellipsize="end" 
android:gravity="center" 
android:layout_width="fill_ parent" 
android:layout height-"wrap content" /> 
<ImageView 
android:layout_width="fill_ parent" 
android:layout height-"1dip" 
android:scaleType-"fitX Y" 
android:gravity="fill_ horizontal" 
android:src-"(drawable/dialog divider horizontal light" 
android:layout marginLeft-"10dip" 
android:layout marginRight-"10dip"/» 
<com.android.superdeskclock.DigitalClock 
style="@style/clock" 
android:padding Top="30dip" 
android:paddingBottom="30dip" 
android: baselineAligned="true" 
android:gravity="center_horizontal"> 
<TextView android:id="@+id/timeDisplay" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:textSize="64sp" 
android:textColor-"?android:attr/textColorPrimary"/» 
«TextView апагоіа:ід="@+ід/ат pm" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:textStyle-"bold" 
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android:textAppearance="?android:attr/textAppearanceMedium" 
android:textColor="?android:attr/textColorPrimary"/> 
</com.android.superdeskclock.DigitalClock> 
<LinearLayout 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
style="@android:style/ButtonBar"> 
<Button 
android:id="@+id/snooze" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout_weight="3" 
android:text="@string/alarm_alert_snooze_text" /> 
<!— blank stretchable view —> 
<View 
android:layout_width="2dip" 
android:layout_height="2dip" 
android:layout gravity-"fill horizontal" 
android:layout_weight="1"/> 
<Button 
android:id="@+id/dismiss" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:layout_weight="3" 
android:text="@string/alarm_alert_dismiss_text" /> 
</LinearLayout> 
</LinearLayout> 
</LinearLayout> 


(2) 再 看 文件 AlarmAlertjava， 功 能 是 实现 全 屏幕 的 闹钟 提示 ， 使 用 持久 性 的 可 见 指示 器 和 指定 
音乐 实现 。 文 件 AlarmAlert.java 的 具体 实现 代码 如 下 所 示 。 
public class AlarmAlert extends AlarmAlertFullScreen { 
// 如 果 尝试 操作 键盘 锁 的 5 次 以 上 ， 则 退出 全 屏幕 活动 
private int mKeyguardRetryCount; 
private final int MAX_KEYGUARD_CHECKS = 5; 


private final Handler mHandler = new Handler() { 
@Override 
public void handleMessage(Message msg) { 
handleScreenOff((KeyguardManager) msg.obj); 


} 
y 
private final BroadcastReceiver mScreenOffReceiver = 
new BroadcastReceiver() ( 
@Override 
public void onReceive(Context context, Intent intent) ( 
KeyguardManager km = 


(KeyguardManager) context.getSystemService( 
Context.KEYGUARD_SERVICE); 
handleScreenOff(km); 
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} 


} 
k 


@Override 
protected void onCreate(Bundle icicle) { 
super.onCreate(icicle); 


// 当 屏幕 恢复 时 监听 屏幕 关闭 ， 这 样 用 户 不 需要 解锁 解除 闹钟 
registerReceiver(mScreenOffReceiver, 
new IntentFilter(Intent ACTION_SCREEN_OFF)); 


} 

@Override 

public void onDestroy() { 
super.onDestroy(); 
unregisterReceiver(mScreenOffReceiver); 
/删除 任何 键盘 锁 消 息 
mHandler.removeMessages(0); 

} 

@Override 

public void onBackPressed() { 
finish(); 

} 


private boolean checkRetryCount() { 
if (mKeyguardRetryCount++ >= MAX_KEYGUARD_CHECKS) ( 
Log.e("Tried to read keyguard status too many times, bailing..."); 
return false; 
} 
return true; 
} 
private void handleScreenOff(final KeyguardManager km) { 
if (‘km.inKeyguardRestrictedInputMode() && checkRetryCount()) ( 
if (checkRetryCount()) ( 
mHandler.sendMessageDelayed(mHandler.obtainMessage(0, кт), 500); 
} 
}else { 
/人 肩 动 全 屏 活动 但 不 打开 屏幕 
Intent i = new Intent(this, AlarmAlertFullScreen.class); 
i.putExtra(Alarms.ALARM INTENT EXTRA, mAlarm); 
i.putExtra(SCREEN OFF, true); 
startActivity(i); 
finish(); 


) 


(3) 再 看 文件 AlarmAlertFullScreen,java， 功 能 是 实现 有 背景 桌面 的 、 被 锁定 的 全 屏幕 闹钟 提示 效 


果 ， 此 类 型 闹钟 使 用 持久 性 的 可 见 指示 器 和 指定 音乐 实现 。 文 件 AlarmAlertFullScreen,java 的 具体 实现 
代码 如 下 所 示 。 
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public class AlarmAlertFullScreen extends Activity ( 


/下 面 的 值 和 文件 “xml/settings.xml” 中 的 相对 应 

private static final String DEFAULT_SNOOZE = "10"; 

private static final String DEFAULT VOLUME BEHAVIOR = "2"; 
protected static final String SCREEN OFF = "screen off"; 


protected Alarm mAlarm; 
private int mVolumeBehavior; 


IIJ) AlarmKlaxon #1 ALARM KILLED 操作 ， 也 从 其 他 程序 接收 ALARM SNOOZE ACTION / ALARM_ 
DISMISS_ACTION 
private BroadcastReceiver mReceiver = new BroadcastReceiver() { 
@Override 
public void onReceive(Context context, Intent intent) { 
String action = intent.getAction(); 
if (action.equals(Alarms.ALARM SNOOZE ACTION)) { 
snooze(); 
} else if (action.equals(Alarms.ALARM DISMISS ACTION)) { 
dismiss(false); 
) else { 
Alarm alarm = intent.getParcelableExtra(Alarms.ALARM INTENT EXTRA); 
if (alarm != null && mAlarm.id == alarm.id) { 
dismiss(true); 


} 


y: 


@Override 
protected void onCreate(Bundle icicle) ( 
super.onCreate(icicle); 


mAlarm = getintent().getParcelableExtra(Alarms.ALARM_INTENT_EXTRA); 


// 获 取 声 音 和 相机 设置 
final String vol = 
PreferenceManager.getDefaultSharedPreferences(this) 
.getString(SettingsActivity.KEY VOLUME BEHAVIOR, 
DEFAULT VOLUME BEHAVIOR); 
mVolumeBehavior 7 Integer.parselnt(vol); 


requestWindowFeature(android.view.Window.FEATURE NO TITLE); 


final Window win = getWindow(); 
win.addFlags(WindowManager.LayoutParams.FLAG SHOW WHEN LOCKED 
| WindowManager.LayoutParams.FLAG DISMISS KEYGUARD); 
// 打 开 屏 幕 
if (IgetIntent().getBooleanExtra(SCREEN OFF, false)) ( 
win.addFlags(WindowManager.LayoutParams.FLAG KEEP SCREEN ON 
| WindowManager.LayoutParams.FLAG TURN SCREEN ON 
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I | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON 
); 
} 


updateLayout(); 


13 个 闹钟 按钮 的 处 理 : 关闭 /睡眠 /解散 

IntentFilter filter = new IntentFilter(Alarms.ALARM KILLED); 
filter.addAction(Alarms.ALARM_SNOOZE_ACTION); 
filter.addAction(Alarms.ALARM_DISMISS_ACTION); 
registerReceiver(mReceiver, filter); 


} 

private void setTitle() { 
String label = mAlarm.getLabelOrDefault(this); 
TextView title = (TextView) findViewByld(R.id.alertTitle); 
title.setText(label); 

) 


private void updateLayout() ( 
Layoutinflater inflater = Layoutinflater.from(this ); 


setContentView(inflater.inflate(R.layout.alarm alert, null)); 


/* snooze behavior: pop a snooze confirmation view, kick alarm 
manager. */ 
Button snooze = (Button) findViewByld(R.id.snooze); 
snooze.requestFocus(); 
snooze.setOnClickListener(new Button.OnClickListener() { 
public void onClick(View v) { 
snooze(); 
} 
y 


/* dismiss 按钮 :关闭 提醒 */ 
findViewByld(R.id.dismiss).setOnClickListener( 
new Button.OnClickListener() ( 
public void onClick(View v) ( 


dismiss(false); 
) 
ys 
PEALE */ 
setTitle(); 
) 
Ше Ле 4 


private void snooze() { 
// 不 要 贪 睡 ，snooze 按钮 被 禁用 
if (findViewByld(R.id.snooze).isEnabled()){ 
dismiss(false); 
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return; 
} 
final String snooze = 
PreferenceManager.getDefaultSharedPreferences(this) 
.getString(SettingsActivity.KEY ALARM SNOOZE, DEFAULT SNOOZE); 
int snoozeMinutes = Integer.parselnt(snooze); 


final long snoozeTime = System.currentTimeMillis() 
+ (1000 * 60 * snoozeMinutes); 
Alarms.saveSnoozeAlert(AlarmAlertFullScreen.this, mAlarm.id, 
snoozeTime); 


/根据 snooze 和 update 的 设置 得 到 显示 时 间 
final Calendar с = Calendar.getlnstance(); 
c.setTimelnMillis(snoozeTime); 


11 Append (snoozed) to the label. 
String label = mAlarm.getLabelOrDefault(this); 
label = getString(R.string.alarm notify snooze label, label); 


EARP, ШЕЕ 
Intent cancelSnooze = new Intent(this, AlarmReceiver.class); 
cancelSnooze.setAction(Alarms.CANCEL SNOOZE); 
cancelSnooze.putExtra(Alarms.ALARM 10, mAlarm.id); 
PendingIntent broadcast = 
PendingIntent.getBroadcast(this, mAlarm.id, cancelSnooze, 0); 
NotificationManager nm = getNotificationManager(); 
Notification n = new Notification(R.drawable.stat_notify_alarm, 
label, 0); 
n.setLatestEventinfo(this, label, 
getString(R.string.alarm_notify_snooze_text, 
Alarms.formatTime(this, c)), broadcast); 
n.flags |= Notification.FLAG AUTO CANCEL 
| Notification.FLAG ONGOING EVENT; 
nm.notify(mAlarm.id, n); 


String displayTime = getString(R.string.alarm alert snooze set, 
snoozeMinutes); 

/故意 延迟 小 睡 的 时 间 

Log.v(displayTime); 


// 在 提醒 中 显示 小 睡 时 间 
Toast.makeText(AlarmAlertFullScreen.this, displayTime, 
Toast.LENGTH_LONG).show(); 
stopService(new Intent(Alarms.ALARM_ALERT_ACTION)); 
finish(); 
} 


private NotificationManager getNotificationManager() { 
return (NotificationManager) getSystemService(NOTIFICATION SERVICE); 
) 
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11 Dismiss 闹钟 
private void dismiss(boolean killed) { 
Log.i(killed ? "Alarm killed" : "Alarm dismissed by user"); 
11 The service told us that the alarm has been killed, do not modify 
II the notification or stop the service 
if (killed) ( 
II Cancel the notification and stop playing the alarm 
NotificationManager nm = getNotificationManager(); 
nm.cancel(mAlarm.id); 
stopService(new Intent(Alarms.ALARM ALERT ACTION)); 


) 

finish(); 
} 
@Override 


protected void onNewintent(Intent intent) { 
super.onNewintent(intent); 
if (Log.LOGV) Log.v("AlarmAlert.OnNewIntent()"); 
mAlarm = intent.getParcelableExtra(Alarms.ALARM_INTENT EXTRA); 
setTitle(); 


} 
@Override 
protected void onResume() { 
super.onResume(); 
II If the alarm was deleted at some point, disable snooze 
if (Alarms.getAlarm(getContentResolver(), mAlarm.id) == null) { 
Button snooze = (Button) findViewByld(R.id.snooze); 
snooze.setEnabled(false); 
} 
} 
@Override 
public void onDestroy() { 
super.onDestroy(); 
if (Log.LOGV) Log.v("AlarmAlert.onDestroy()"); 
11 No longer care about the alarm being killed 
unregisterReceiver(mReceiver); 
} 
@Override 


public boolean dispatchKeyEvent(KeyEvent event) { 

11 Do this on key down to handle a few of the system keys 
boolean up = event.getAction() == KeyEvent.ACTION UP; 
Switch (event.getKeyCode()) ( 

11 Volume keys and camera keys dismiss the alarm 

case KeyEvent.KEYCODE VOLUME UP: 

case KeyEvent.KEYCODE VOLUME DOWN: 

case KeyEvent.KEYCODE CAMERA: 

case KeyEvent.KEYCODE FOCUS: 

if (up) { 
switch (mVolumeBehavior) { 
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сазе 1: 
snooze(); 
break; 

case 2: 
dismiss(false); 
break; 

default: 
break; 

} 
} 
return true; 
default: 
break; 


} 
return super.dispatchKeyEvent(event); 


} 
15.34 重复 设置 


在 系统 中 设置 一 个 益 钟 时 ， 可 以 设置 这 个 闹钟 在 其 他 时 间 也 起 作用 ， 例 如 每 个 周一 或 周二 。 此 功 
能 是 通过 文件 RepeatPreference.java 实现 的 ， 具 体 实现 代码 如 下 所 示 。 
public class RepeatPreference extends ListPreference { 
II Initial value that can be set with the values saved in the database. 
private Alarm.DaysOfWeek mDaysOfWeek = new Alarm.DaysOfWeek(0); 
11 New value that will be set if a positive result comes back from the 
II dialog 
private Alarm.DaysOfWeek mNewDaysOfWeek = new Alarm.DaysOfWeek(0); 


public RepeatPreference(Context context, AttributeSet attrs) { 
super(context, attrs); 


String[ ] weekdays = new DateFormatSymbols().getWeekdays(); 

String[ ] values = new String[] ( 
weekdays[Calendar. MONDAY], 
weekdays[Calendar. TUESDAY], 
weekdays[Calendar. WEDNESDAY], 
weekdays[Calendar. THURSDAY], 
weekdays[Calendar.FRIDAY], 
weekdays[Calendar. SATURDAY], 
weekdays[Calendar.SUNDAY], 

y: 

setEntries(values); 

setEntryValues(values); 


) 


@Override 
protected void onDialogClosed(boolean positiveResult) ( 
if (positiveResult) { 
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mDaysOfWeek.set(mNewDaysOfWeek); 
setSummary(mDaysOfWeek.toString(getContext(), true)); 
callChangeListener(mDaysOfWeek); 


} 


@Override 
protected void onPrepareDialogBuilder(Builder builder) { 
CharSequence[ ] entries = getEntries(); 
@SuppressWarnings("unused") 
CharSequence[ ] entryValues = getEntryValues(); 


builder.setMultiChoiceltems( 
entries, mDaysOfWeek.getBooleanArray(), 
new DialogInterface.OnMultiChoiceClickListener() { 
public void onClick(DialogInterface dialog, int which, 
boolean isChecked) ( 
mNewDaysOfWeek.set(which, isChecked); 


} 
» 
} 
public void setDaysOfWeek(Alarm.DaysOfWeek dow) { 
mDaysOfWeek.set(dow); 
mNewDaysOfWeek.set(dow); 
setSummary(dow.toString(getContext(), true)); 
) 
public Alarm.DaysOfWeek getDaysOfWeek() ( 
return mDaysOfWeek; 
) 


} 
重复 设置 界面 的 执行 效果 如 图 15-7 所 示 。 


Monday 
Tuesday 
Wednesday 


Thursday 


Friday 


15-7 重复 设置 界面 的 执行 效果 
15.8.5 ”闹钟 数据 操作 


在 本 系统 中 ， 采 用 了 SQLiteDatabase 数据 库 来 保存 系统 中 的 数据 ， 例 如 每 个 闹钟 的 时 间 、 
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铃声 和 震动 等 信息 。 和 数据 操作 相关 的 程序 文件 是 AlarmProviderjava， 具 体 实现 代码 如 下 所 示 。 
public class AlarmProvider extends ContentProvider { 
private SQLiteOpenHelper mOpenHelper; 


private static final int ALARMS = 1; 

private static final int ALARMS ID = 2; 

private static final UriMatcher sURLMatcher = new UriMatcher( 
UriMatcher.NO MATCH); 


static ( 


sURLMatcher.addURI("com.android.superdeskclock", "alarm", ALARMS); 


sURLMatcher.addURI("com.android.superdeskclock", "alarm/#", ALARMS_ID); 
) 


private static class DatabaseHelper extends SQLiteOpenHelper ( 
private static final String DATABASE NAME = "alarms.db"; 
private static final int DATABASE_VERSION = 5; 


public DatabaseHelper(Context context) ( 
super(context, DATABASE NAME, null, DATABASE VERSION); 


) 
// 创 建 保 存 数据 库 中 的 每 一 个 选项 
@Override 
public void onCreate(SQLiteDatabase db) { 
db.execSQL("CREATE TABLE alarms (" + 
" id INTEGER PRIMARY KEY," + 
"hour INTEGER, " + 
"minutes INTEGER, " + 
"daysofweek INTEGER, " + 
"alarmtime INTEGER, " + 
"enabled INTEGER, " + 
"vibrate INTEGER, " + 
“message TEXT, " + 
"alert TEXT, "+ 
"times INTEGER, "+ 
"interval INTEGER);"); 


IE PNE 
String insertMe = "INSERT INTO alarms" + 
"(hour, minutes, daysofweek, alarmtime, enabled, vibrate, message, alert,times,interval) " 


"VALUES "; 
db.execSQL(insertMe + "(8, 30, 31, 0, 0, 1, ",",10,0);"); 
db.execSQL(insertMe + "(9, 00, 96, 0, 0, 1, ",",10,0);"); 
} 


@Override 


public void onUpgrade(SQLiteDatabase db, int oldVersion, int currentVersion) { 
if (Log.LOGV) Log.v( 


"Upgrading alarms database from version " + 
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oldVersion + "to " + currentVersion + 

", which will destroy all old data"); 
db.execSQL("DROP TABLE IF EXISTS alarms"); 
onCreate(db); 


} 


public AlarmProvider() { 
} 


@Override 

public boolean onCreate() { 
mOpenHelper = new DatabaseHelper(getContext()); 
return true; 


} 
/查询 系统 中 的 闹钟 数据 
@Override 
public Cursor query(Uri url, String[ ] projectionIn, String selection, 
String[ ] selectionArgs, String sort) { 
SQLiteQueryBuilder qb = new SQLiteQueryBuilder(); 


II Generate the body of the query 
int match = sURLMatcher.match(url); 
switch (match) { 
case ALARMS: 
qb.setTables("alarms"); 
break; 
case ALARMS 10: 
qb.setTables("alarms"); 
qb.appendWhere(" id="); 
qb.appendWhere(url.getPathSegments().get(1)); 
break; 
default: 
throw new lllegalárgumentException("Unknown URL " + url); 
} 


SQLiteDatabase db = mOpenHelper.getReadableDatabase(); 
Cursor ret = qb.query(db, projectionin, selection, selectionArgs, 
null, null, sort); 


if (ret == null) { 

if (Log.LOGV) Log.v("Alarms.query: failed"); 
) else { 

ret.setNotificationUri(getContext().getContentResolver(), url); 
) 


return ret; 


} 
/获取 类 型 信息 
@Override 
public String getType(Uri url) { 
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int match = sURLMatcher.match(url); 
switch (match) { 
case ALARMS: 
return "vnd.android.cursor.dir/alarms"; 
case ALARMS ID: 
return "vnd.android.cursor.item/alarms"; 
default: 
throw new IllegalArgumentException("Unknown URL"); 
} 


} 
// 更 新 系统 中 的 闹钟 信息 
@Override 
public int update(Uri url, ContentValues values, String where, String[ ] whereArgs) ( 
int count; 
long rowld = 0; 
int match = sURLMatcher.match(url); 
SQLiteDatabase db - mOpenHelper.getWritableDatabase(); 
Switch (match) ( 
case ALARMS ID: ( 
String segment = url.getPathSegments().get(1); 
rowld 7 Long.parseLong(segment); 
count = db.update("alarms", values, " id=" + rowld, null); 


break; 
) 
default: { 
throw new UnsupportedOperationException( 
"Cannot update URL: " + url); 
) 


) 

if (Log.LOGV) Log.v("*** notifyChange() rowld: " + rowld + " url " + url); 
getContext().getContentResolver().notifyChange(url, null); 

return count; 


) 


@Override 
public Uri insert(Uri url, ContentValues initialValues) í 
if (SURLMatcher.match(url) != ALARMS) { 
throw new IllegalArgumentException("Cannot insert into URL: " + url); 
} 


ContentValues values = new ContentValues(initialValues); 


SQLiteDatabase db = mOpenHelper.getWritableDatabase(); 
long rowld = db.insert("alarms", Alarm.Columns.MESSAGE, values); 
if (rowld < 0) ( 

throw new SQLException("Failed to insert row into " + url); 


} 
if (Log.LOGV) Log.v("Added alarm rowld = " + rowld); 


Uri newUrl = ContentUris.withAppendedld(Alarm.Columns.CONTENT URI, rowld); 
getContext().getContentResolver().notifyChange(newUn, null); 


O 
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return newUrl; 


/删除 信息 
public int delete(Uri url, String where, String[ ] whereArgs) { 
SQLiteDatabase db = mOpenHelper.getWritableDatabase(); 
int count; 
long rowld = 0; 
Switch (sURLMatcher.match(url)) { 
case ALARMS: 
count = db.delete("alarms", where, whereArgs); 
break; 
case ALARMS 10: 
String segment = url.getPathSegments().get(1); 
rowld 7 Long.parseLong(segment); 
if (TextUtils.isEmpty(where)) { 
where = " id=" + segment; 
) else { 
where = "_id=" + segment + " AND (" + where + ")"; 
} 
count = db.delete("alarms", where, whereArgs); 
break; 
default: 
throw new IllegalArgumentException("Cannot delete from URL: " + url); 
} 
getContext().getContentResolver().notifyChange(url, null); 
return count; 
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在 图 15-2 所 示 的 界面 中 ， 如 果 触 摸 按 下 四 图 标 则 会 获取 SD 卡 中 的 音乐 文件 ， 在 里 面 可 以 选择 一 
个 音乐 文件 作为 闹钟 铃声 。 此 功能 是 通过 文件 ChooseBellActivityjava 实现 的 , 具体 实现 代码 如 下 所 示 。 
public class SetBellPreference extends ListPreference{ 
private Uri mAlert; 
private PreferenceActivity preferenceActivity; 
private int mld; 
public SetBellPreference(Context context, AttributeSet attrs) { 
super(context, attrs); 
this. preferenceActivity=(PreferenceActivity)context; 
String[ ] values = context.getResources().getStringArray(R.array.choose bell); 
mld-preferenceActivity.getIntent().getlntExtra(Alarms.ALARM ID, -1); 
setEntries(values); 
setEntryValues(values); 
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@Override 
protected void onPrepareDialogBuilder(Builder builder) { 
CharSequence{ ] entries = getEntries(); 


builder.setSingleChoiceltems(entries, -1, new DialogInterface.OnClickListener() í 
public void onClick(DialogInterface dialog, int which) { 
switch (which) { 

case 0: 
break; 

case 1: 
Intent intent = new Intent(preferenceActivity, ChooseBellActivity.class); 
intent.putExtra(Alarms.ALARM_ID, mld); 
intent.putExtra("TYPE", 1); 
preferenceActivity.startActivity(intent); 
preferenceActivity.finish(); 
break; 

case 2: 
Intent intent2 = new Intent(preferenceActivity, ChooseBellActivity.class); 
intent2.putExtra(Alarms.ALARM ID, mld); 
intent2.putExtra(" TYPE", 2); 
preferenceActivity.startActivity(intent2); 
preferenceActivity.finish(); 
break; 

default: 
break; 


}); 
} 


@Override 
protected void onDialogClosed(boolean positiveResult) { 
if (positiveResult) { 
Alarm 
alarm=com.android.superdeskclock.Alarms.getAlarm(preferenceActivity. getContentResolver(),mld); 
alarm.silent=true; 
alarm.alert=Uri.parse("silent’); 
mAlert=alarm.alert; 
ContentValues values = com.android.superdeskclock.Alarms.createContentValues(alarm); 
ContentResolver resolver = preferenceActivity.getContentResolver(); 
resolver.update(ContentUris.withAppendedld(Alarm.Columns.CONTENT URI, alarm.id),values, 
null, null); 


setSummary(R.string.silent alarm summary); 


) 


public void setAlert(Uri alert) ( 
mAlert = alert; 
if (alert != null) { 
final Ringtone r = RingtoneManager.getRingtone(getContext(), alert); 


ә 
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if (r != null) { 
setSummary(r.getTitle(getContext())); 
} 
) else ( 


setSummary(R.string.silent alarm summary); 
) 
) 


public Uri getAlert() { 
return mAlert; 
} 
} 
因为 是 在 模拟 器 中 运行 ， 所 以 执行 效果 如 图 15-8 所 示 。 


Your phone doesn't have USB 
storage 


图 15-8 执行 效果 
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随 着 硬件 移动 设备 越 来 越 先 进 ， 人 们 对 移动 设备 的 要 求 也 越 来 越 高 ， 从 追求 技术 到 追求 视觉 ， 逐 
步 提高 了 对 系统 的 要 求 。Android 作为 一 个 开源 的 系统 ， 本 章 的 音乐 播放 器 实例 就 采用 了 Android 开源 
系统 技术 , 利用 Java 语言 和 Eclipse 编辑 工具 对 播放 器 进行 编写 ， 同 时 给 出 了 详细 的 系统 设计 过 程 、 部 
分 界面 图 及 主要 功能 运行 流程 图 。 在 本 章 的 内 容 中 ， 还 对 开发 过 程 中 遇 到 的 问题 和 解决 方法 进行 了 详 
细 的 讨论 。 本 章 讲 解 的 音乐 播放 器 实例 集 播放 、 和 暂停 、 停 止 、 上 一 首 、 下 一 首 、 音 量 调节 、 歌 词 显示 
等 功能 于 一 体 ， 性 能 良好 ， 在 Android 系统 中 能 独立 运行 。 该 播放 器 还 拥有 对 手机 文件 浏览 器 的 访问 
功能 、 歌 曲 播放 模式 以 及 歌词 开 闭 状 态 的 友好 设置 。“.MP3” 的 全 名 是 MPEG Audio Layer-3， 是 一 种 
声音 文件 的 压缩 格式 。 因 为 本 播放 器 只 限于 应 用 层 程序 的 探讨 ， 所 以 对 具体 的 压缩 算法 不 作 深究 。 
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本 章 播 放 器 源码 保存 在 本 书 附带 光盘 中 的 “光盘 :\daima\16” 目 录 下 。 在 讲解 具体 编码 之 前 ， 先 简 
要 介绍 本 项 目的 产生 背景 和 项 目 目的 知识 ， 为 后 面 的 具体 编码 打 好 理论 基础 。 


16.1.1 项 目 背景 介绍 


随 着 社会 生活 的 节奏 越 来 越 快 ， 人 们 对 手机 的 要 求 也 越 来 越 高 ， 由 于 手机 市 场 发 展 迅 速 ， 使 得 手 
机 操作 系统 也 出 现 了 不 同 的 分 类 , 现在 的 市 场 上 主要 有 3 个 手机 操作 系统 : Windows Mobile. Symbian, 
以 及 谷歌 的 Android 操作 系统 ,其 中 占有 开放 源 代码 优势 的 Android 系统 有 最 大 的 发 展 前 景 。 那么 能 否 
在 手机 上 拥有 自己 编写 的 个 性 音乐 播放 器 呢 ? 答案 是 完全 可 以 ! 谷歌 Android 系统 就 能 做 到 。 本 章 讲 
解 的 音乐 播放 器 实例 就 是 基于 谷歌 Android 手机 平台 的 播放 器 。 

随 着 计算 机 的 广泛 运用 和 手机 市 场 的 迅速 发 展 ， 各 种 音频 、 视 频 资源 也 在 网 上 广 为 流 传 ， 这 些 资 
源 看 似 平常 , 但 已 经 渐渐 成 为 人 们 生活 中 必 不 可 少 的 一 部 分 。 于 是 各 种 手机 播放 器 也 紧 跟 着 发 展 起 来 ， 
但 是 很 多 播放 器 一 味 追求 外 观 花哨 ， 功 能 庞大 ， 对 用 户 的 手机 造成 了 很 多 资源 浪费 ， 比 如 CPU、 内 存 
等 的 占用 率 过 高 ， 在 用 户 需 要 多 任务 操作 时 ， 受 到 了 不 小 的 影响 ， 带 来 了 许多 不 便 ， 而 对 于 大 多 数 普 
通用 户 ， 许 多 功能 用 不 上 ， 形 同 虚设 。 针 对 以 上 各 种 弊端 ， 本 项 目 选择 了 开发 多 语种 的 音频 视频 播放 
器 ， 将 各 种 性 能 优化 ， 继 承 播放 器 的 常用 功能 ， 满 足 一 般 用 户 〈 如 听 歌 、 看 电影 ) 的 需求 ， 除 了 能 播 
放 常见 格式 的 语音 视频 文件 ， 高 级 功能 还 能 播放 RMVB 格式 的 视频 文件 。 此 外 ， 还 能 支持 中 文 、 英 文 
等 语言 界面 。 

要 研究 各 种 市 场 上 流行 的 手机 播放 器 ， 了 解 它们 各 自 的 插件 及 编码 方式 ， 还 有 各 种 播放 器 播放 的 
特别 格式 文件 ， 分 析 各 种 编码 的 优 缺 点 以 及 各 种 播放 器 本 身 存 在 的 缺陷 和 特点 ， 编 写 出 功能 实用 、 使 


用 方便 快捷 的 播放 器 。 目 前 已 经 实现 的 功能 有 能 播放 常见 音频 文件 的 功能 ， 例 如 MP3 和 WAV 等 ; 拥 
有 播放 菜单 ， 能 选择 播放 清单 ， 具 备 一 般 播 放 器 的 功能 ， 如 快 进 、 快 退 、 音 量 调节 等 。 播 放 模式 也 比 
较 完 善 ， 例 如 有 单 曲 播放 、 顺 序 播放 、 循 环 播放 和 随机 播放 等 模式 。 


16.1.2 项 目的 目的 


当今 社会 人 们 的 工作 压力 大 ， 而 欣赏 音乐 是 最 好 的 舒缓 压力 的 方式 之 一 。 本 项 目的 目的 是 开发 一 个 
可 以 播放 主流 音乐 文件 格式 的 播放 器 ， 该 播放 器 的 主要 功能 是 播放 МРЗ. МАУ 等 多 种 格式 的 音乐 文件 
能 够 控制 播放 、 和 暂停 、 停 止 、 上 一 曲 、 下 一 曲 音乐 ， 也 具备 音量 调节 功能 ， 并 且 具 有 很 好 的 视觉 外 观 ， 
还 具有 播放 列表 和 歌曲 文件 的 管理 操作 等 多 种 播放 控制 功能 ， 界 面 简 明 ， 操 作 简 单 。 

本 项 目 是 一 款 基于 Android 手机 平台 的 音乐 播放 器 , 使 Android 手机 拥有 个 性 的 多 媒体 播放 器 ， 显 
得 更 生动 灵活 ， 与 人 们 更 为 接近 ， 让 手机 主人 随时 随地 处 于 音乐 视频 的 旋律 之 中 ， 使 人 们 的 生活 更 加 
多 样 化 ， 也 使 设计 者 更 加 熟练 Android 的 技术 和 其 他 在 市 场 上 的 特点 。 


16.2 系统 需求 分 析 


Gl 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 16 章 \ 系 统 需求 分 析 .avi 

根据 项 目的 目标 ， 我 们 可 获得 项 目 系统 的 基本 需求 ， 以 下 从 不 同 角度 来 描述 系统 的 需求 ， 并 且 使 
用 例 图 来 描述 ， 系 统 的 功能 需求 分 成 四 部 分 来 概括 ， 即 播放 器 的 基本 控制 需要 、 播 放 列表 管理 需求 、 
播放 器 友好 性 需求 和 播放 器 扩展 卡 需 求 。 


16.2.1 构成 模块 
本 系统 的 构成 模块 如 图 16-1 所 示 。 
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图 16-1 系统 构成 模块 
各 个 模块 的 具体 说 明 如 下 所 示 。 
1. 播放 控制 模块 
播放 控制 模块 的 功能 是 控制 播放 的 音乐 文件 。 


(m, 


(1) 播放 


о В: 使 得 用 户 可 以 播放 在 播放 列表 中 选中 的 歌曲 。 


O WHA: 播放 器 正在 运行 。 
оО 基本 事件 流 : 
> ”用户 单 击 “ 播 放 ” 按 钮 。 
> ”播放 器 将 播放 列表 中 的 当前 歌曲 。 
(2) 暂停 播放 
Q 目标 : 使 得 用 户 可 以 暂停 正在 播放 的 歌曲 。 
Q 前 置 条 件 : 歌曲 正在 播放 且 未 停止 和 暂停 。 
оО 基本 事件 流 : 
€ Gub UT FL. 
+ 播放 器 将 暂停 当前 的 歌曲 。 
(3) 停止 播放 
оО 目标 : 使 得 用 户 可 以 停止 正在 播放 的 歌曲 。 
O 前 置 条 件 : 歌曲 正在 播放 或 暂停 。 
Q 基本 事件 流 : 
+ JHO h "Eb" 按钮。 
令 “ 播放 器 将 停止 当前 播放 的 歌曲 。 
(4) 上 一 首 / 下 一 首 
о Abs: 使 得 用 户 可 以 听 上 一 首 或 下 一 首 歌曲 。 
O 前 置 条 件 : 歌曲 正在 播放 或 暂停 。 
Па 基本 事件 流 : 
令 “ 用 户 单 击 “ 上 一 首 ” 或 “下 一 首 ”按钮 。 
令 “ 播放 器 将 播放 上 一 首 或 下 一 首 歌曲 。 
(5) 播放 清单 
O 目标 : 使 得 用 户 可 以 进入 播放 清单 。 
о WHA: 程序 在 运行 。 
о 基本 事件 流 : 
+ Hg eo gu. 
令 “ 播放 器 进入 清单 列表 。 
播放 控制 的 基本 结构 如 图 16-2 所 示 。 


2. 播放 清单 列表 管理 


aoe ки-твк®йн ООШ 


当 用 户 选中 列表 中 的 某 一 项 歌曲 后 会 显示 播放 清单 ， 我 们 可 以 进行 如 下 操作 。 


(1) 播放 
оО 目标 : 使 程序 播放 选中 的 歌曲 。 
口 前 置 条 件 : 程序 运行 在 播放 菜单 选项 中 。 
口 基本 事件 流 : 
分 ”用 户 单 击 “ 播 放 ” 按 钮 。 
+ ”播放 器 进入 播放 状态 。 


С 


音乐 播放 器 的 基本 功能 
播放 [了 7 退出 播放 程序 
暂停 
f 进入 播放 清单 


Z] 


上 一 首 /下 一 首 
用 户 


E 
音量 控制 d 


静音 控制 
歌词 显示 


图 16-2 播放 控制 模块 的 结构 


(2) 视频 详情 
о HE: 使 得 程序 显示 歌曲 详情 。 
O WHA: 程序 运行 在 播放 菜单 选项 中 。 
о 基本 事件 流 : 
令 “ 用 户 单 击 “ 详 细 ” 按 钮 。 
+ 显示 歌曲 详细 状态 。 
(3) 增加 
о 目标 : 使 得 程序 进入 手机 扩展 SD 卡 。 
口 前 置 条 件 : 程序 运行 在 播放 菜单 选项 中 。 
о 基本 事件 流 : 
令 “ 用 户 单 击 “ 增 加 ”按钮 。 
+o 播放 器 进入 手机 扩展 SD E. 
(4) 移 除 /全 部 移 除 
口 目标 : 使 选中 的 歌曲 被 移 除 。 
O 前 置 条 件 : 程序 运行 在 播放 菜单 选项 中 。 
Па 基本 事件 流 : 
令 “ 用 户 单 击 “ 移 除 /全 部 移 除 ”按钮 。 
信 ”播放 器 移 除 选中 歌曲 /全 部 移 除 歌曲 。 


(5) 设 定 
口 目标 : 使 得 程序 进入 播放 器 设 定 状态 。 
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口 前 置 条 件 : 程序 运行 在 播放 菜单 选项 中 。 
口 基本 事件 流 : 

令 “ 用 户 单 击 “ 设 定 ” 按 钮 。 

vo 播放 器 进入 设 定 界 面 。 
本 实例 播放 清单 界面 的 结构 如 图 16-3 所 示 。 


3. 播放 设置 模块 


本 模块 用 于 设置 音乐 的 播放 方式 ， 并 设置 是 否 显示 歌词 。 
(1) 播放 模式 
口 目标 : 使 得 程序 进入 播放 模式 设 定 状态 。 
о WHA: 程序 运行 在 播放 器 设 定 界面 中 。 
а 基本 事件 流 : 
令 “ 用 户 单 击 “ 顺 序 ”“ 随 机 ”“ 单 曲 ” 按 钮 。 
vo 播放 器 进入 选中 模式 播放 状态 。 
(2) 显示 歌词 
口 目标 : 使 得 程序 进入 播放 器 歌词 设置 状态 。 
о 前 置 条 件 : 程序 运行 在 播放 器 设 定 界面 中 。 
口 基本 事件 流 : 
令 “ 用 户 单 击 “ 歌 词 开关 按钮 ”按钮 。 
令 “ 播放 器 显示 或 关闭 歌词 。 
本 实例 设置 的 结构 如 图 16-4 所 示 。 
当 用 户 选中 某 一 首 歌曲 
应 有 的 菜单 


播放 


aa inci e 
ec, 2 
Crs 


——e 

用 户 was i 增加 播放 模式 "ҮТ 
be e ы 

Рт 用 户 。 系统 设 定 9, 


2068 sm 
We 
16-3 ”播放 清单 界面 结构 16-4 设置 界面 结构 
4. 文件 浏览 器 
此 模块 的 功能 是 浏览 系统 内 或 SD 卡 中 的 文件 信息 。 
(1) SDcard 


口 目标 : 使 得 程序 进入 SDcard 目 录 。 
口 前 置 条 件 : 程序 运行 在 目录 界面 中 。 


Aro sae RE 


N 

. 文件 浏览 器 用 户 可 以 浏览 手机 扩展 卡 和 系统 

Па 基本 事件 流 : 文件 扩展 SD 卡 中 显示 .MP3 和 ,Wav 格式 的 音频 
FAP ia; SDeard 选项 。 iF ERRARE 


分 ”程序 进入 SDcard 目录 。 | ee 
(2) System x] hw 
用 户 é D 


O 目标 : 使 得 程序 进入 System 目录 。 


/SDcard 


О WHA: 程序 运行 在 目录 界面 中 。 N ннн 
n 基本 事件 流 : /System 

> FAP ii System 选项 。 мей Wav Hist 

分 ”程序 进入 System 目录 下 。 RUE 


本 实例 文件 浏览 器 模块 的 结构 如 图 16-5 所 示 。 
1622 ”系统 流程 
本 章 音乐 播放 器 的 系统 流程 如 图 16-6 所 示 。 


16-5 文件 浏览 器 模块 结构 


— 播放 设 定 文件 浏览 器 添加 歌曲 
程序 结束 


16-6 音乐 播放 器 系统 流程 图 
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16.2.3 ”功能 结构 图 


本 章 音 乐 播放 器 系统 的 完整 功能 结构 如 图 16-7 所 示 。 


音乐 播放 器 
设 定 播放 列表 播放 界面 | [ 文件 浏览 菜单 
ЕЕ Е: pi 
S | [зе [а 
НЕНИ 
| | Las] RI 
清 | ра 
-- = # [H 
Ë 
: 返回 到 上 一 级 
四 内 


SSS Г] 
EESE 


16-7 “完整 功能 结构 图 
16.2.4 ”系统 功能 说 明 


本 章 音 乐 播放 器 系统 各 个 模块 功能 的 说 明 如 表 16-1 所 示 。 
表 16-1 模块 结构 功能 说 明 信 息 表 


能 类 别 | Tm E | f 功 能 


退出 播放 
азе 从 扩展 卡 寻 找 歌曲 


播放 一 进入 播放 界面 


播放 列表 删除 一 数据 库 同步 更 新 


重 命 名 一 数据 库 同步 更 新 


向 上 、 下 移动 一 数据 库 同步 更 新 
播放 歌曲 一 线程 启动 一 时 间 更 新 


暂停 歌曲 一 线程 暂停 一 时 间 暂 停 


播放 界面 停止 歌曲 一 线程 停止 一 时 间 停 上 


播放 列表 索引 变化 一 寻找 上 一 ID 歌曲 


播放 列表 索引 变化 一 寻找 下 一 ID 歌曲 


O 


Aros BER RE 


功能 类 别 子 功 
返回 到 播放 列表 
返回 到 主 菜单 
播放 界面 播放 界面 菜单 从 扩展 卡 寻找 歌曲 
退出 播放 器 

隐藏 播放 界面 
程序 退出 


进入 播放 列表 显示 播放 列表 
16.2.5 ”系统 需求 


(1) 系统 界面 需求 

播放 器 界面 要 求 布 局 合理 ， 颜 色 和 舒适， 控制 按钮 友好 ， 为 了 减少 开发 
工程 量 ， 图 片 素材 多 数 为 公司 项 目 素材 ， 如 图 16-8 所 示 。 

(2) 系统 性 能 需求 

根据 Android 手机 系统 要 求 无 响应 时 间 为 5 秒 , 所 以 就 有 如 下 性 能 要 求 : 

Q 当 要 求 歌曲 播放 时 ， 程 序 响应 时 间 最 长 不 能 超过 5 秒 。 

Q 当 要 求 歌曲 暂停 时 ， 程 序 响应 时 间 最 长 不 能 超过 5 秒 。 

Q 当 要 求 歌曲 停止 时 ， 程 序 响应 时 间 最 长 不 能 超过 5 秒 。 

Q 当 要 求 歌曲 上 /下 一 首 时 ， 程 序 响应 时 间 最 长 不 能 超过 5 秒 。 

O 当 要 求 进行 清单 列表 时 ， 程 序 响应 时 间 最 长 不 能 超过 5 秒 。 

(3) 运行 环境 需求 

口 操作 系统 ，Android 手 机 基于 Linux 操 作 系 统 。 

О 支持 环境 : Android 1.5 - 2.0.1 版 本 。 图 16-8 播放 器 主 界面 

口 开发 环境 : Eclipse 3.5 АРТ 0.95. 


Re 


163 数据库 设 计 


ШИ 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 16 章 \ 数 据 库 设计 .avi 

数据 库 是 存放 数据 的 仓库 ， 只 不 过 这 个 仓库 是 在 计算 机 存储 设备 上 ， 而 且 数据 是 按 一 定 的 格式 存 
放 的 。 数 据 库 中 的 数据 按 一 定数 据 模型 组 织 、 描 述 和 存储 ， 具 有 较 小 的 重复 度 、 较 高 的 数据 独立 性 和 
易 扩 展 性 ， 并 且 可 以 被 在 一 定 范 围 内 的 各 种 用 户 共享 。 在 涉及 数据 库 的 软件 开发 中 ， 需 要 根据 有 待 解 
决 的 问题 性 质 、 规 模 ， 以 及 所 采用 的 前 端 程序 创建 工具 等 ， 作 出 合适 的 数据 库 类 型 选择 。 


16.3.1 字段 设计 


FR file table 用 于 保存 歌曲 的 名 字 、 类 型 和 路 径 ， 具 体 说 明 如 表 16-2 所 示 。 
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表 16-2 字段 file table 说 明 
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属 性 数据 类 型 x Е 
14 INTEGER id 号 
fileName TEXT 歌曲 名 字 
filePath TEXT 歌曲 路 径 
sort INTEGER 歌曲 类 型 
SD 卡 中 保存 歌曲 用 表 16-3 中 的 字段 来 保存 。 
表 16-3 歌曲 详情 表 

属 性 数据 类 型 й Е 
ID INTEGER id 号 
TITLE TEXT 标题 
ARTIST TEXT 艺术 家 
ALBUM TEXT 专辑 
SIZE LONG 大 小 


在 Android 系统 中 ， 通 过 自 带 的 MediaStore 封闭 类 来 存储 媒体 信息 ， 通 过 Uri EXTERNAL_ 
CONTENT URI 来 访问 SDcard 中 的 歌曲 详细 信息 。 


16.3.2 E-R 图 设计 


音乐 播放 器 的 E-R 图 如 图 16-9 所 示 。 


йн Ско Сий) 
ERK 歌曲 Ст) 
N 
Cem D C» 
组 成 
1 
Giza D | mus 
音乐 播放 器 | — li ^ СВ 
图 16-9 ERA 
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16.3.3 ”数据 库 连接 


在 Android 系统 中 自 带 iSQLite 数据 库 ， 这 是 一 个 十 分 小 型 的 数据 库 ， 这 样 正 适合 Android 这 种 移 
动 平台 使 用 。Android 数据 库存 储 的 位 置 在 “data/data/< 项 目 文件 夹 >/databases/” 目 录 下 。 

Android 使 用 ContentProvider 作为 内 容 提供 商 , SQLiteOpenHelper 数据 库 帮助 类 来 进行 对 数据 库 的 
创建 和 操作 。 通 过 Context.getContentResolver() 方 法 直接 对 数据 库 进 行 操作 。 程 序 中 数据 库 类 为 


DBHelper extends SQLiteOpenHelper (继承 关系 ), 内 容 提供 类 为 DBProvider extends ContentProvider (Ak 
承 关系 )。 


16.3.4 创建 数据 库 


Android 提供 了 标准 的 数据 库 创建 方式 。 继 承 自 SQLiteOpenHelper， 实 现 onCreate 和 onUpgrade 
两 个 方法 ， 这 样 的 好 处 是 便于 数据 库 版 本 的 升级 。 在 此 编写 文件 DBHelperjava， 实 现 连 接 数据 库 的 算 
法 ， 具 体 代 码 如 下 所 示 。 

public class DBHelper extends SQLiteOpenHelper{ 

p 


* 数据 库 名 称 常量 
i 
private static final String DATABASE NAME = "MyMusic.db"; 
p 
* 数据 库 版 本 常量 
Eh 
private static final int DATABASE VERSION = 1; 
p 
* RAMEE 
t 
public static final String TABLES TABLE NAME - "File Table"; 
private static final Sting DATABASE CREATE = "CREATE TABLE " + FileColumn.TABLE +" (" 
+ FileColumn.ID*" integer primary key autoincrement," 
+ FileColumn.NAME +" text," 
+ FileColumn.PATH+" text," 
+ FileColumn.SORT+" integer," 
+ FileColumn.TYPE+" text)"; 
p 
* 构造 方法 
*@param context 
al 
public DBHelper(Context context) { 
// 创 建 数据 库 
super(context, DATABASE_NAME,null, DATABASE VERSION); 
} 


* 创建 时 调用 
gi 
public void onCreate(SQLiteDatabase db) { 


/*Locale | = new Locale("zh", "CN"); 
@ 
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db.setLocale(I);*/ 
db.execSQL(DATABASE CREATE); 


p 
* 版 本 更 新 时 调用 
yl 
public void onUpgrade(SQLiteDatabase db, int old Version, int newVersion) ( 
[zs 
db.execSQL("DROP TABLE IF EXISTS File Table"); 
onCreate(db); 
} 
} 
如 果 创 建 数 据 库 不 成 功 则 抛 出 FIleNotFoundException 异常 。 


16.3.5 “操作 数据 库 


Android 对 数据 库 的 操作 主要 有 插入 、 删 除 、 更 新 、 查 询 操作 ， 在 进行 任何 操作 时 都 必须 指定 一 个 
Uri， 才 能 对 相应 的 表 进 行 数据 操作 。 编 写 文件 DBProviderjava， 在 里 面 分 别 编写 数据 插入 、 修 改 、 查 
询 和 删除 操作 的 实现 方法 ， 具 体 代码 如 下 所 示 。 

public class DBProvider extends ContentProvider { 

private DBHelper dbOpenHelper; 
public static final String AUTHORITY = "MUSIC"; 
public static final Uri CONTENT URI = Uri.parse("content://" + AUTHORITY 
+"/" + FileColumn.TABLE); 
@Override 
public int delete(Uri arg0, String arg1, String[ ] arg2) { 
SQLiteDatabase db = dbOpenHelper.getWritableDatabase(); 


db.delete(FileColumn.TABLE, arg1, arg2); 
Log.i("info", "delete"); 
} catch (Exception ex) { 
ex.printStackTrace(); 
Log.e("error", "delete"); 
} 
return 1; 


} 


* 待 实现 
7 
@Override 
public String getType(Uri uri) { 
return null; 


@Override 
public Uri insert(Uri uri, ContentValues values) { 


Android Sk TER Sc 


) 


SQLiteDatabase db = dbOpenHelper.getWritableDatabase(); 
long count = 0; 
try { 
count = db.insert(FileColumn.TABLE, null, values); 
} catch (Exception ex) { 
ex.printStackTrace(); 
Log.e("error", "insert"); 


} 
if (count > 0) 
return uri; 
else 
return null; 
} 
@Override 


public boolean onCreate() { 
dbOpenHelper = new DBHelper(getContext()); 
return true; 
} 
p 
* 根据 条 件 查询 
* @retum 数据 集 
di 
@Override 
public int update(Uri uri, ContentValues values, String selection, 
String[ ] selectionArgs) { 
SQLiteDatabase db = dbOpenHelper.getWritableDatabase(); 
int i = 0; 
try { 
i = db.update(FileColumn. TABLE, values, selection, null); 
return i; 
} catch (Exception ex) { 
Log.e("error", "update"); 
} 
return 0; 


16.3.6 ”数据 显示 


本 项 目 在 显示 数据 时 ， 利 用 Cursor 游标 类 指向 数据 表 中 的 某 一 项 ， 然 后 进 


日 志 显 示 出 来 。 
/| 数据 库 查 询 操作 
@Override 
public Cursor query(Uri uri, String[ ] projection, String selection,String[ ] selectionArgs, String sortOrder) { 


SQLiteDatabase db = dbOpenHelper.getWritableDatabase(); 


/依次 参数 为 : 表 名 ， 查 询 字段 ，where ы], BR 
Iigroup by( 分 组 )，having( 分 组 条 件 ),order by( 排 序 ) 
Cursor сиг = db.query(FileColumn.TABLE, projection, selection,selectionArgs, null, null, sortOrder); 
return cur;} 


6. 


rtr. Ji 


ËH] Log 
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164 具体 编码 


GH 知 识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 16 章 \ 具 体 编码 .avi 
经 过 前 面 内 容 的 讲解 ， 本 播放 器 实例 项 目的 前 期 工作 已 经 结束 。 在 接 下 来 的 内 容 中 ， 将 详细 讲解 
本 项 目的 具体 编码 过 程 。 


16.4.1 设置 服务 信息 


编写 文件 SystemService.java， 在 此 设置 项 目的 服务 信息 ， 主 要 代码 如 下 所 示 。 
public class SystemService { 
private Context context; 
private Cursor cursor; 
public SystemService(Context context) { 
this.context = context; 


} 


public Cursor allSongs() { 
if (cursor != null) 
return cursor; 
ContentResolver resolver = context.getContentResolver(); 
cursor = resolver.query(MediaStore.Audio.Media.EXTERNAL_CONTENT_URI, 
null, null, null, MediaStore.Audio.Media.DEFAULT_SORT_ORDER); 
return cursor; 


} 


p 

* 读 取 正在 播放 歌曲 的 艺术 家 

* @retum 

T 
public String getArtist() { 

return cursor.getString(cursor 
.getColumnIndexOrThrow(MediaStore.Audio.Media.ARTIST)); 

} 


* 


* 读 取 正 在 播放 的 歌曲 名 字 

*@retun 歌曲 名 字 

E 

public String getTitle() ( 
String title = cursor.getString(cursor 
.getColumnindexOrThrow(MediaStore.Audio.Media.TITLE)); 
try( 
title=EncodingUtils.getString(title.getBytes(), "UTF-8"); 

} catch (Exception e) { 


e.printStackTrace(); 
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return title; 
} 


p 

* 读 取 正 在 播放 歌曲 的 专辑 

* @retum 专辑 名 

* @throws RemoteException 

Ч] 
public String getAlbum() throws RemoteException { 

return cursor.getString(cursor 
.getColumnindexOrThrow(MediaStore.Audio.Media.ALBUM)); 

} 


/*public int getDuration() throws RemoteException { 
// 获 得 当前 歌曲 的 时 长 
retum player.getDuration(); 
}public int getTime() throws RemoteException { 
// 获 得 当前 的 媒体 时 间 
return player.getCurrentPosition(); 
} 


1642 SEIT 


Android 的 每 一 个 可 视 化 界面 ， 都 有 其 唯一 的 布局 配置 文件 ， 该 文件 里 面 有 各 种 布局 方式 和 各 种 资 
源 文件 ， 如 图 像 、 文 字 、 颜 色 的 引用 ， 程 序 在 运行 时 ， 可 以 通过 代码 对 各 配置 文件 进行 读 取 。 这 样 就 
可 以 形成 不 同 的 可 视 化 界面 和 炫丽 的 效果 。 

a) 本 实例 主 界面 的 布局 文件 是 main.xml， 主 要 代码 如 下 所 示 。 

<TextView 

android:id="@+id/current_music" 
android:layout_width="fill_ parent" 
android:layout height-"wrap content" 
android:textSize="16sp" 
android:textColor="#fffffr" 
android:padding="10dip" 
android:cacheColorHint="#00000000" 
android:text="this is TextView..." 
android:layout_y="320px"/> 
一 > 

«Gallery android:id="@+id/gallery" 

android:layout_width="fill_ parent" 
android:layout_height="200dp" 
android:layout_alignParentLeft="true" 
android:spacing="16dp" 
android:cacheColorHint="#00000000" 
android:layout centerVertical-"true" 
android:layout_y="20px"/> 

«SeekBar android:id="@+id/seekbar" android:layout width-"245px" 

android:layout height-"20px" android:layout. x-"40px" 
android:progressDrawable-"(g)drawable/seekbar style" 
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android:thumb="@drawable/thumb" 
android: paddingLeft="18px" 
android:paddingRight="15px" 
android:paddingTop-"5px" 
android:paddingBottom="5px" 
android:progress="0" 
android:max="100" 
android:secondaryProgress="0" 
android:layout_y="350px"/> 
<TextView android:layout_x="60px" android:layout height-"wrap content" 
android:text="00:00" android:layout_y="370px" android:id-"(G)*id/current time text" 
android:layout_width="wrap_content"></TextView> 
<TextView android:layout_x="230px" android:layout_height="wrap_content" 
android:text="00:00" android:layout_y="370px" android:id="@+id/end_Time_Text" 
android:layout_width="wrap_content"></TextView> 
<LinearLayout android:orientation-"horizontal" 
android:gravity-"center" 
android:layout_y="423px" 
android:layout height="wrap content" 
android:layout_width="fill_parent" 
android:background="@drawable/buttonground" /> 
<l-- 建立 第 一 个 ImageButton --> 
«ImageButton 
android:id="@+id/btStart" 
android:layout_height="70dp" 
android:layout_width="70dp" 
android:layout_x="145px" 
android:layout_y="390px" 
android:background="#00000000" 
android:src="@drawable/play" 
> 
<l- 建立 第 二 个 ImageButton 
<ImageButton 
android:id="@+id/pause" 
android:layout_height="wrap_content" 
android:layout width-"wrap content" 
android:background="#00000000" 
android:layout_x="141 px" 
android:layout_y="50px" 
android:src="@drawable/pause" 
> 
<l- 建立 第 三 个 ImageButton -> 
<ImageButton 
android:id="@+id/before" 
android:layout height-"70dp" 
android:layout_width="70dp" 
android:background="#00000000" 
android:layout_x="80px" 
android:layout_y="280px" 
android:src="@drawable/backward" 
> 


ш 
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<l- 建立 第 四 个 ImageButton 一 > 
<ImageButton 
android:id="@+id/next" 
android:layout_height="70dp" 
android:layout_width="70dp" 
android:background="#00000000" 
android:layout_x="210px" 
android:layout_y="280px" 
android:src="@drawable/forward" 
[> 
<l- 建立 第 五 个 ImageButton 一 > 
<ImageButton 
android:id="@+id/btStop" 
android:layout_height="70dp" 
android:layout_width="70dp" 
android:layout_x="145px" 
android:layout_y="280px" 
android:background="#00000000" 
android:src="@drawable/stop" 
> 


«ImageButton 
android:id="@+id/listplay" 
android:layout height-"70dp" 
android:layout widthz"70dp" 

android:cacheColorHint="#00000000" 
android:layout_x="50px" 
android:layout_y="390px" 
android:background="#00000000" 
android:src="@drawable/itunes2" /> 
«L- 
«ImageButton 
android:id="@+id/player" 
android:layout_height="70dp" 
android:layout widthz"70dp" 
android:cacheColorHint="#00000000" 
android:layout x-"140px" 
android:layout_y="390px" 
android:background="#00000000" 
android:src="@drawable/wmp2" /> 
一 > 
«ImageButton 
android:id="@+id/returnBt" 
android:layout_height="70dp" 
android:layout_width="70dp" 
android:cacheColorHint="#00000000" 
android:layout_x="230px" 
android:layout_y="390px" 
android:background="#00000000" 
android:src="@drawable/white" 
> 


@. 


О 实现 界面 初始 化 工作 ， 如 果 有 播放 的 歌曲 则 在 播放 器 中 显示 歌 
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(2) 播放 器 主 界面 是 一 个 Activity, Android 工程 在 每 个 activity 启动 的 时 候 会 首先 执行 Oncreate() 
方法 。 本 实例 主 界面 的 程序 文件 是 MainPlayActivityjava， 其 具体 实现 流程 如 下 所 示 。 


名 ， 并 显示 上 次 的 播放 进度 。 


如 果 设 置 了 显示 歌词 ， 则 还 会 在 界面 中 显示 歌词 。 对 应 代码 如 下 所 示 。 
public void onCreate(Bundle savedInstanceState) { 

super.onCreate(savedinstanceState); 
requestWindowFeature(Window.FEATURE_NO_TITLE); 
setContentView(R.layout.main); 
systemProvider=new SystemService(this); 
cursor=systemProvider.allSongs(); 
SharedPreferences sp = getSharedPreferences("MUSIC", MODE WORLD READABLE); 
if (sp != null) ( 


} 


playingName = sp.getString("PLAYINGNAME", null); 
selectName = sp.getString("SELECTNAME", null); 
String s = sp.getString("MUSIC_LIST", null); 
if (s != null) 

music List = StringHelper.spiltString(s); 


init Play Rack(); 
if (playingName !- null) {// 


) 


int time1 = mplayer.getDuration(); 

int time2 = mplayer.getCurrentPosition(); 
seekBar.setMax(time1); 
seekBar.setProgress(time2); 

currently Time.setText(getFileTime(time2)); 
end Time.setText(getFileTime(time1)); 
currently Music.setText(playingName); 


handler.removeCallbacks(thread One); 
handler.postDelayed(thread One, 1000); 
Irc time = new ArrayList<String>(); 

Irc word = new ArrayList<String>(); 
showLrc(playingName); 


if (selectName != null) { 


) 


play bt.setlmageBitmap(musicAdapter.getSuspend Ісоп()); 
play Music(); 

Irc time = new ArrayList<String>(); 

Irc word = new ArrayList<String>(); 

showLrc(selectName); 


if ((currently Music.getText().toString()).equals("c")) ( 


play bt.setOnTouchListener(playListener); 
seekBar.setOnSeekBarChangeListener(seekBarListener); 
stop_bt.setOnTouchListener(stopListener); 
move_Down.setOnTouchListener(downListener); 
move_Up.setOnTouchListener(upListener); 


URBAN 


[LA 


/| 播放 选中 的 歌曲 
ERAS ats 


/歌词 显示 


/| 播放 监听 器 
IESUS TIT RR 
/停止 监听 器 
/下 一 首 歌曲 监听 器 
/修一 首 歌曲 监听 器 
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list bt.setOnTouchListener(list bt listener); /清单 监听 器 
back bt.setOnTouchListener(return bt listener); 
mplayer.setOnCompletionListener(playerListener); /监听 歌曲 是 否 播放 完 


mSwitcher = (ImageSwitcher) findViewByld(R.id.switcher); 
mSwitcher.setFactory(this); 
mSwitcher.setInAnimation(AnimationUtils.loadAnimation(this, 
android.R.anim.fade in)); 
mSwitcher.setOutAnimation(AnimationUtils.loadAnimation(this, 
android.R.anim.fade out)); 
mSwitcher.setlmageResource(R.drawable.background); 
Gallery д = (Gallery) findViewByld(R.id.gallery); 
g.setAdapter(new ImageAdapter(this)); 
g.setSelection(200); 
g.setOnltemSelectedListener(this); 
) 
О 设置 暂停 和 重 置 处 理 ， 对 应 代码 如 下 所 示 。 
protected void onPause() { 
super.onPause(); 
SharedPreferences sp = getSharedPreferences("MUSIC", 
MODE_WORLD_WRITEABLE); 
SharedPreferences.Editor editor = sp.edit(); 
playingName = currently_Music.getText().toString(); 
if (IplayingName.equals(" c") 
editor.putString("PLAYINGNAME", playingName); 
editor.putString("SELECTNAME", selectName); 
editor.putString("MUSIC_LIST", StringHelper.toStringAll(music List)); 
editor.commit(); 
handler.removeCallbacks(thread One); 


) 
@Override 


protected void onResume() { 

super.onResume(); 

systemProvider=new SystemService(this); 

cursor=systemProvider.allSongs(); 

SharedPreferences sp = getSharedPreferences("MUSIC", MODE WORLD READABLE); 

if (sp != null) ( 
playingName = sp.getString("PLAYINGNAME", null); 
selectName = sp.getString("SELECTNAME", null); 
String s = sp.getString("MUSIC LIST", null); 
if (s != null) 

music List = StringHelper.spiltString(s); 

) 

if (mplayer.isPlaying()) { 
handler.removeCallbacks(thread_One); 
handler.postDelayed(thread_One, 1000); 

} 

else 
handler.removeCallbacks(thread_One); 
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@Override 
protected void onDestroy() { 

super.onDestroy(); 

Log.i("info", "onDestroy"); 

new File("/data/data/com.Rain.music.activity/shared prefs/MUSIC.xml") 

.delete(); 
new File("/data/data/com.Rain.music.activity/shared prefs/SET MSG.xml") 
-delete(); 

System.exit(0); 
y 
定义 方法 init Play_Rack0， 实 现 主 界面 的 初始 化 处 理 ， 对 应 代码 如 下 所 示 。 
private void init Play Rack(){ 

list_bt = (ImageButton) findViewByld(R.id.listplay); 

back_bt = (ImageButton) findViewByld(R.id.retumBt); 

stop_bt = (ImageButton) findViewByld(R.id.btStop); 

play. bt = (ImageButton) findViewByld(R.id.btStart); 

move Up = (ImageButton) find ViewByld(R.id.before); 

move Down = (ImageButton) findViewByld(R.id.next); 

end Time = (TextView) findViewByld(R.id.end Time Text); 

//title_Music = (TextView) findViewByld(R.id.title music); 

currently Time = (TextView) findViewByld(R.id.current time text); 

currently Music = (TextView) findViewByld(R.id.current music); 

seekBar = (SeekBar) find ViewByld(R.id.seekbar); 


mplayer = MusicHelp.getMediaPlayer(); 
musicAdapter = new MusicAdapter(this, music List); 
handler = MusicHelp.getHandler(); 
currently Music.setText(" 7"); 
currently Music.setTextColor(Color. WHITE); 
currently Time.setTextColor(Color.WHITE); 
end Time.setTextColor(Color. WHITE); 
IrcTime = (TextView) find ViewByld(R.id.Irc Text); 
SharedPreferences sp = getSharedPreferences("SET MSG", 
MODE WORLD READABLE); 
if (sp != null) ( 
if (sp.getString("sigle Play", null) != null) ( 
play Mode 7 sp.getString("sigle Play", null); 
) 
if (sp.getString("order Play", null) != null) { 
play Mode - sp.getString("order Play", null); 
} 
if (sp.getString("random Play", null) != null) { 
play Mode = sp.getString("random Play", null); 
) 
if (sp.getString("lyLrc", null) != null) ( 
Irc Show = sp.getString("lyL rc", null); 


i("info", "play Mode-" + play Mode); 
Log.i("info", "Irc Showz" + Irc Show); 
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O 定义 方法 onCompletion0， 实 现 歌 曲 播放 完 监听 器 功能 ， 对 应 代码 如 下 所 示 。 
OnCompletionListener playerListener = new OnCompletionListener() { 

@Override 

public void onCompletion(MediaPlayer mp) { 


play_Mode();// 播放 模式 
Irc time = new ArrayList<String>(); 
Irc_word = new ArrayList<String>(); 
showLrc(selectName); 
} 
y: 
О 定义 retum_bt listener， 实 现 结束 监听 器 处 理 ， 对 应 代码 如 下 所 示 。 
OnTouchListener return_bt_listener = new OnTouchListener() { 
@Override 
public boolean onTouch(View v, MotionEvent event) { 
if (event.getAction() == MotionEvent. ACTION_DOWN) { 
back bt.setlmageResource(R.drawable.whitepress); 
) else if (event.getAction() == MotionEvent.ACTION UP) ( 
back bt.setlmageResource(R.drawable.white); 
finish(); 
onDestroy(); 
|| | android.os.Process.killProcess(android.os.Process.myPid()); 
/获取 PID， 目 前 获取 自己 的 也 只 有 该 API， 否则 从 自己 的 /proc 中 枚 举 其 他 进程 
|| | System.exit(0); 
) 
return false; 
) 
y: 
O 定义 list_bt listener， 实 现 清单 监听 器 的 处 理 ， 对 应 代码 如 下 所 示 。 
OnTouchListener list_bt_listener = new OnTouchListener() { 
@Override 
public boolean onTouch(View v, MotionEvent event) { 
if (event.getAction() == MotionEvent. ACTION_DOWN) { 
|| | v.setBackgroundResource(R.drawable.share pressed); 
list bt.setlmageResource(R.drawable.itunespress); 
} else if (event.getAction() == MotionEvent.ACTION UP) { 
/v.setBackgroundResource(R.drawable.share); 
list bt.setlmageResource(R.drawable.itunes2); 


Intent intent = new Intent(MainPlayActivity.this, 
PlayListActivity.class); 
startActivityForResult(intent, 0); 
} 
return false; 
} 
} 
О 定义 OnSeekBarChangeListener seekBarListener， 实 现 音 轨 监 听 器 处 理 操作 ， 对 应 代码 如 下 所 示 。 
private OnSeekBarChangeListener seekBarListener = new OnSeekBarChangeListener() { 
@Override 


e 
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public void onProgressChanged(SeekBar seekBar, int progress, 
boolean fromUser) { 
if (fromUser) { 
mplayer.seekTo(progress); 
currently Time.setText(getFileTime(progress)); 
} 
} 
@Override 
public void onStopTrackingTouch(SeekBar seekBar) { 
} 
@Override 
public void onStartTrackingTouch(SeekBar seekBar) { 
} 
y: 
O 定义 playListener， 实 现 播放 监听 器 的 操作 处 理 ， 对 应 代码 如 下 所 示 。 
OnTouchListener playListener = new OnTouchListener() { 
@Override 
public boolean onTouch(View v, MotionEvent event) { 
if (event.getAction() == MotionEvent ACTION DOWN) { 
if (mplayer.isPlaying()) { 
play bt.setlmageResource(R.drawable.pausepress); 


} 
else { 

play. bt.setlmageResource(R.drawable.playpress); 
} 


} else if (event.getAction() == MotionEvent.ACTION_UP) { 
if (mplayer.isPlaying()) { 
mplayer.pause();// 暂 停 
currently_Time.setText(currently_Time.getText().toString()); 
play bt.setlmageBitmap(musicAdapter.getPlay Icon()); 
handler.removeCallbacks(thread One); 


) 
else ( 
if (is stopping) ( 
play Music(); 
is stopping = false; 
play bt.setlmageBitmap(musicAdapter.getSuspend Ісоп()); 
) else { 
mplayer.start(); 
handler.postDelayed(thread_One, 1000); 
play_bt.setlmageBitmap(musicAdapter.getSuspend_Icon()); 
} 
} 
} 
return false; 


y: 
О 定义 stopListener， 实 现 停止 监听 器 的 处 理 ， 对 应 代码 如 下 所 示 。 
OnTouchListener stopListener = new OnTouchListener(){ 

@Override 
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public boolean onTouch(View у, MotionEvent event) { 

if (event.getAction() == MotionEvent ACTION DOWN) { 
Stop bt.setlmageResource(R.drawable.stoppress); 

) else if (event.getAction() == MotionEvent.ACTION UP) ( 
Stop bt.setlmageResource(R.drawable.stop); 
mplayer.stop(); 
currently Time.setText("00:00"); 
end Time.setText("00:00"); 
play btsetlmageBitmap(musicAdapter.getPlay Icon()); 
handler.removeCallbacks(thread One); 


seekBar.setProgress(1); 
is stopping = true; 
IrcTime.setText(" c"); 

) 

retum false; 


} 
y 
O 定义 downListener， 实 现下 一 首 歌曲 监听 器 的 操作 处 理 ， 对 应 代码 如 下 所 示 。 
OnTouchListener downListener = new OnTouchListener() { 
@Override 
public boolean onTouch(View v, MotionEvent event) { 
if (event.getAction() == MotionEvent.ACTION DOWN) { 
move Down.setlmageResource(R.drawable.forwardpress); 


} else if (event.getAction() == MotionEvent.ACTION UP) { 
move Down.setlmageResource(R.drawable.forward); 
move Down(currently Music.getText().toString()); 

Irc time = new ArrayList<String>(); 
Irc_word = new ArrayList<String>(); 
showLrc(currently Music.getText().toString());//Bkis] S; 
) 
return false; 
} 
Е 
O 定义 upListener， 实 现 上 一 首 歌曲 监听 器 的 操作 处 理 ， 对 应 代码 如 下 所 示 。 
OnTouchListener upListener = new OnTouchListener() { 
@Override 
public boolean onTouch(View v, MotionEvent event) { 

if (event.getAction() == MotionEvent ACTION DOWN) { 
move_Up.setImageResource(R.drawable.backwardpress); 

} else if (event.getAction() == MotionEvent.ACTION UP) { 
move Up.setlmageResource(R.drawable.backward); 
move Up(currently Music.getText().toString()); 

Irc time = new ArrayList<String>(); 
Irc word = new ArrayList<String>(); 
showLrc(currently_Music.getText().toString());// 歌词 显示 

} 


return false; 
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О 定义 方法 move_ Down0 和 move_Up0, 分 别 用 于 播放 下 一 首 歌曲 和 上 一 首 歌曲 , 对 应 代码 如 下 所 示 。 
private void move_Down(String musicName) { 
for (int i = 0; i < music_List.size(); i++) { 
if (musicName.equals(music_List.get(i))) { 
if (i + 1) < music List.size()) { 
selectName = music_List.get(i + 1); 
play_Music(); 
return; 
) else { 
selectName = music_List.get(0); 
play Music(); 
return; 


} 


private void move_Up(String musicName) { 
for (int i = 0; i < music List.size(); i++) { 
if (musicName.equals(music_List.get(i))) { 

if ((i- 1) >= 0){ 
selectName = music List.get(i - 1);// 移 动 到 上 一 首 歌 曲 
play_Music(); 
return; 

} else { 
selectName = music_List.get(music_List.size() - 1); 
play_Music(); 
return; 


} 
} 
口 定义 方法 play Mode() 来 设置 系统 的 播放 模式 ， 本 实例 有 单 曲 循环 、 顺 序 播 放 和 随机 播放 3 种 模 
式 。 对 应 代码 如 下 所 示 。 
private void play_Mode() { 
if ("is_Sigle".equals(play_Mode)) {// 单 曲 循环 
play_Music(); 


} 
if ("is_Order".equals(play_Mode)) {// 顺 序 播放 
move_Down(currently_Music.getText().toString()); 


} 
if ("is_Random".equals(play_Mode)) {// 随 机 播放 
Random r = new Random(); 
int idx = r.nextInt(music_List.size());//BEHL A [0,тиѕіс List.size())89 INT 值 
selectName = music List.get(idx); 
play_Music(); 
} 
} 
О 定义 方法 play_Music0 播 放 指定 的 音乐 文件 ， 对 应 代码 如 下 所 示 。 
private void play_Music() { 
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ty{ 


mplayer.reset(); 
mplayer.setDataSource(query());// 文 件 流 中 选择 歌曲 
mplayer.prepare(); 
mplayer.start(); 
currently Music.setText(selectName); 
F 
if(cursor.moveToFirst()){ 
String title=systemProvider.getArtist(); 
currently Music.setText(title); 
yl 


seekBar.setMax(mplayer.getDuration());// 音 频 文件 持续 时 间 
seekBar.setProgress(1); 
currently Time.setText(getFileTime(mplayer.getCurrentPosition())); 
|| \rcTime.setText(systemProvider.getArtist()); 
handler.removeCallbacks(thread One); 
end Time.setText(getFileTime(mplayer.getDuration())); 
handler.postDelayed(thread One, 1000); 
} catch (Exception e) { 
e.printStackTrace(); 
) 
) 
Q 定义 方法 query() 查 询 歌曲 路 径 ， 对 应 代码 如 下 所 示 。 
public String query() { 
ContentResolver cr = getContentResolver(); 
Uri uri = DBProvider. CONTENT URI; 
String[ ] projection = { "path" }; 
String selection = "fileName=?"; 
String[ ] selectionArgs = { selectName }; 
Cursor c = cr.query(uri, projection, selection, selectionArgs, null); 
if (c.moveToFirst()) { 
String path = c.getString(0); 
return path; 
} 


return null; 


О 定义 方法 getFileTime() 获 取 音乐 文件 的 播放 持续 时 间 长 的 格式 化 字符 串 ， 其 返回 值 是 一 个 格式 化 
时 间 字 符 串 。 对 应 代码 如 下 所 示 。 
private String getFileTime(int timeMs) { 
int totalSeconds = timeMs / 1000;// 获 取 文件 有 多 少 秒 
StringBuilder mFormatBuilder = new StringBuilder(); 
Formatter mFormatter = new Formatter(mFormatBuilder, Locale 
.getDefault()); 
int seconds = totalSeconds % 60; 
int minutes = (totalSeconds / 60) % 60; 
int hours = totalSeconds / 3600; 
mFormatBuilder.setLength(0); 
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if (hours > 0){ 
return mFormatter.format("%d:%02d:%02d", hours, minutes, seconds) 
.toString();/ 格 式 化 字符 囊 
) else ( 
return mFormatter.format("%02d:%02d", minutes, seconds).toString(); 
) 
} 
另外 在 文件 MainPlayActivityRootjava 中 ,定义 了 主 界 面 中 控制 按钮 的 响应 方法 ， 
如 下 所 示 。 
p 
* 清单 按钮 
yi 
protected ImageButton list_bt; 
p 
* 返回 按钮 
3 
protected ImageButton back bt; 
p 
* 停止 按钮 
«f 
protected ImageButton stop bt; 
p 
* 播放 按钮 
ff 
protected ImageButton play_bt; 
p 
* 上 一 首 歌曲 
4 
protected ImageButton move Up; 
p 
“下 一 首 歌曲 
4j 
protected ImageButton move Down; 
p 
* 歌曲 结束 时 间 
yi 
protected TextView end Time; 
p 
* 当前 播放 时 间 
"il 
protected TextView currently Time; 
p 
* 当前 播放 时 间 
9] 
protected TextView currently_Music; 
p 
“вй 
s 
protected SeekBar seekBar; 


主要 实现 代码 
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protected TextView IrcTime; 


p 
Š 播放 器 是 否 停止 

ы boolean is_stopping = false; 
"жа 自 带 播放 器 控件 

— MediaPlayer mplayer; 


б 
* 选中 的 歌曲 

di 

protected String selectName; 
p 

* 正在 播放 的 歌曲 

* 
protected String playingName; 

p 

* 播放 模式 : 默认 为 随机 播放 模式 

df 

protected String play_Mode = "is_Random"; 

p 

* 歌词 显示 模式 

protected String Irc_Show; 

p 

* 歌曲 列表 

2 

protected List<String> music List = new ArrayList<String>(); 
p 

* 线程 

protected Handler handler; 


16.4.3 ”播放 列表 功能 


系统 的 歌曲 列表 界面 如 图 16-10 所 示 。 


歌曲 列表 


16-10 歌曲 列表 界面 
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СТ) 编写 布局 文件 play_list.xml， 主 要 代码 如 下 所 示 。 
«LinearLayout android:layout_width="fill_ parent" 

android:gravity-"center" android:layout height-"wrap content" 

android:background="@drawable/footer_bar"> 

<TextView android:text=" 歌 曲 列表 " android:id="@+id/music_list" 
android:textSize="@dimen/music_list_title" android:textStyle="bold" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content"></TextView> 


</LinearLayout> 


<ListView android:id-"(g)*id/show play list" 
android:layout_width="fill_ parent" android:layout_height="337px"></ListView> 
<LinearLayout android:layout_width="fill_parent" 
android:gravity="right" android:layout height-"wrap content" 
android:background="@drawable/footer_bar"> 
«ImageButton android:id="@+id/back" android:background="@drawable/back" 
android:layout_width="wrap_content" android:layout_height="wrap_content"></ImageButton> 
</LinearLayout> 
在 Android 系统 中 有 一 个 名 为 ListView 的 视图 ， 其 特点 是 一 个 有 BaseAdapter 的 属性 ， 从 上 到 下 ， 


或 从 左 到 右 的 显示 方式 。 系 统 默认 的 方式 每 一 行 只 显示 一 个 TextView， 本 播放 列表 实现 了 自 定义 的 方 
XX. M ListView 的 每 一 行 显示 一 个 音乐 图 片 和 一 个 歌曲 名 字 。 在 此 定义 了 类 MusicAdapter 来 继承 
BaseAdapter, 然后 通过 算法 对 这 个 适配器 进行 扩展 , 扩展 成 为 第 一 行 能 显示 一 张 图 片 和 一 个 歌曲 名 字 。 
由 于 BaseAdapter 是 一 个 抽象 类 ， 我 们 需要 实现 里 面 的 抽象 方法 getView()， 该 方法 返回 一 个 View， 即 
视图 。 视 图 可 以 显示 在 Activity 上 ， 所 以 就 可 以 看 到 我 们 想 要 的 歌曲 列表 界面 。 


fh, 当 点 击 到 每 一 行 时 , 可 以 通过 ListView.getItemAtPositon(int position) 得 到 
该 行 上 的 信息 。 这 样 就 可 以 通过 Intent 将 数据 传 入 到 其 他 的 Activity。 本 程 
序 的 思路 是 当 点 击 一 行 ， 会 跳 转 到 另 一 个 Activity 里 面 ， 这 个 Activity 和 歌 


it 


中 有 歌曲 列表 的 存在 。 因 为 每 次 歌曲 列表 显示 时 会 查询 数据 库 中 的 歌曲 列表 。 


ListView 同样 有 一 个 监听 器 new onItemClickListener()， 我 们 只 要 实现 这 个 方法 就 可 以 监听 点 击 事 


列表 类 似 ， 也 是 一 个 ListView， 该 界面 将 在 16.4.4 节 介 绍 。 
歌曲 列表 是 从 播放 主 界面 跳 转 过 来 的 ， 能 跳 到 该 歌曲 列表 的 前 提 是 数据 库 


Di 


果 不 存在 会 提示 是 空 列表 ， 选 择 到 SDCard 中 添加 歌曲 ， 如 图 16-11 所 示 。 
(2) 编写 程序 文件 PlayListActivity.java， 首 先 定义 方法 setListener() 来 


监听 用 户 的 选择 操作 ， 将 用 户 选择 的 歌曲 进行 播放 ， 然 后 定义 方法 query) 
来 查询 系统 库 内 的 歌曲 ， 如 果 为 空 则 显示 “播放 列表 为 空 ”， 最 后 定义 方法 


showDialog() 来 显示 图 16-11 所 示 的 提示 框 。 文 件 PlayListActivity.java 的 主 图 16-11 列表 为 空 时 的 提示 
要 代码 如 下 所 示 。 


private void setListener(){ 
playlist.setOnltemClickListener(new OnltemClickListener() { 
@Override 
public void onltemClick(AdapterView<?> arg0, View arg], int arg2, 
long arg3) { 
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Intent intent = new Intent(PlayListActivity.this, Menu.class); 
selectName = playlist.getltemAtPosition(arg2).toString(); 
startActivityForResult(intent, 2); 

} 


» 
back.setOnTouchListener(new OnTouchListener() { 


@Override 
public boolean onTouch(View v, MotionEvent event) { 


if (event.getAction() == MotionEvent.ACTION_DOWN) { 
v.setBackgroundResource(R.drawable.back pressed); 

} else if (event.getAction() == MotionEvent.ACTION_UP) { 
v.setBackgroundResource(R.drawable.back); 
Intent intent = new Intent(); 
intent.setClass(PlayListActivity.this, MainPlayActivity.class); 

setResult(0, intent); 


finish(); 
} 
retum false; 
} 
» 
) 
@Override 
protected void onPause() { 
super.onPause(); 
Log.v("log", "playListActivity is in pause state"); 
SharedPreferences sp-getSharedPreferences("MUSIC", MODE_WORLD_WRITEABLE); 
SharedPreferences.Editor editor-sp.edit(); 
editor.putString("SELECTNAME", selectName); 
String str-StringHelper.toStringAIl(list); 
editor.putString("MUSIC LIST", str); 
editor.commit(); 
) 


public String[ ] query() 切 查询 数据 库 
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cr = getContentResolver(); 
uri = DBProvider. CONTENT URI; 
list.clear(); 
String[ ] projection = ( "filename", "path" }; 
Cursor c = cr.query(uri, projection, null, null, null); 
if (c.getCount() == 0) ( 
showDialog(" 播 放 列 表 为 空 "); 
} 
String[ ] music = new String[c.getCount()]; 
if (c.moveToFirst()) { 
for (int i = 0; i < c.getCount(); i++) { 
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c.moveToPosition(i); 
String filename = c.getString(0); 
music[i] = filename; 
list.add(filename); 
} 
} 
if (music.length > 0) { 
playlist.setAdapter(new MusicAdapter(this, list)); 
} 
return music; 


} 


private void showDialog(String msg) { 
AlertDialog.Builder builder = new AlertDialog.Builder(this); 
builder.setMessage(msg).setCancelable(false).setPositiveButton("JÀ SD +", 
new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, int id) ( 
Intent intent = new Intent(PlayListActivity.this, 
FileExplorerActivity.class); 
||  startActivity(intent); 
startActivityForResult(intent, 2); 


} 
)).setNegativeButton(" 取 消 ", new OnClickListener() { 
@Override 
public void onClick(DialogInterface dialog, int which) { 
Intent intent = new Intent(); 
setResult(0, intent); 
finish(); 
} 
» 
AlertDialog alert = builder.create(); 
alert.show(); 


} 
16.4.4 菜单 功能 模块 


本 系统 实例 的 菜单 功能 界面 如 图 16-12 所 示 。 


选项 


Э 85 
Зза 
= sa 


16-12 菜单 选项 界面 
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(1) 编写 布局 文件 menu.xml， 主 要 代码 如 下 所 示 。 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" android:layout_width="fill_parent" 
android:layout height-"fill parent" android:background="@drawable/list_bg"> 
«LinearLayout android:layout width-"fill parent" 
android:gravity="center" android:layout height-"wrap content" 
android:background="@drawable/footer_bar"> 
<TextView android:text=" 选 项 " android:id="@tid/select_item" 
android:textSize="@dimen/music_list_title" android:textStyle="bold" 
android:layout_width="wrap_content" android:layout_height="wrap_content"></TextView> 
</LinearLayout> 
«ListView android:id="@+id/menu" android:layout_width="wrap_content" 
android:background="@drawable/list_item_bg" 
android:layout_height="wrap_content"></ListView> 
<TextView android:layout_width="wrap_content" 
android:layout_height="50px"></TextView> 
<LinearLayout android:layout_width="fill_ parent" android:gravity-"right" 
android:layout_height="wrap_content" 
android:background="@drawable/footer_bar"> 
<ImageButton android:id="@+id/back" 
android:background="@drawable/back" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content"></ImageButton> 
</LinearLayout> 
(2) 编写 文件 menujava， 其 具体 实现 流程 如 下 。 
O 使 用 List<String> 容 器 保存 String 类 型 的 字符 ,保存 了 “播放 ”、“ 新 增 ”、“ 详 细 ”、“ 移 除 ” 
“全 部 移 除 ”和 “设置 ”等 选项 。 对 应 代码 如 下 所 示 。 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.menu); 
menuLV = (ListView) findViewByld(R.id.menu); 
back=(ImageButton)findViewByld(R.id.back); 
select Item = (TextView) findViewByld(R.id.select_item); 
select Item.setTextColor(Color. WHITE); 
SharedPreferences sp = getSharedPreferences("MUSIC", 
MODE WORLD READABLE); 
if (sp != null) ( 


selectName-sp.getString("SELECTNAME^, null); 
} 


List<String> seclect_items = new ArrayList<String>(); 
seclect items.add(" EX); 

seclect items.add(" i48"); 

seclect items.add( 3/18"); 

seclect items.add(" Ж"); 

seclect items.add(" £R"); 

seclect items.add("i$ Ж"); 

menuLV.setAdapter(new MusicAdapter(this, seclect items)); 


back.setOnTouchListener(backListener) 
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口 使 用 case 语 句 根据 用 户 选 择 的 选项 来 到 对 应 的 界面 ， 对 应 代码 如 下 所 示 。 
menuLV.setOnltemClickListener(new OnltemClickListener() { 
@Override 
public void onltemClick(AdapterView<?> arg0, View arg1, int arg2, 
long arg3) { 


SharedPreferences sp=getSharedPreferences("MUSIC", MODE_WORLD_WRITEABLE); 


SharedPreferences.Editor editor=sp.edit(); 
switch (arg2) { 
case 0:// 播放 
Bundle bundle = new Bundle(); 
bundle.putInt("operate", 0); 
Intent intent = new Intent(); 
intent.putExtras(bundle); 
setResult(2, intent); 
finish(); 
break; 
case 2: 
Intent intent_add = new Intent(Menu.this, 
FileExplorerActivity.class); 
editor.putString("SELECTNAME", null); 
editor.commit(); 
|| _ startActivity(intent_add); 
startActivityForResult(intent_add, 3); 
break; 
case 3:// 移 除 
showDialog(selectName); 
break; 
case 4:// 全 部 移 除 
showDialog(""); 
break; 
case 5:// 设 置 
Intent intent_set = new Intent(Menu.this, PlaySetting.class); 
editor.putString("SELECTNAME", null); 
editor.commit(); 
startActivityForResult(intent_set, 3); 
break; 
default: 
break; 


} 


» 
) 


O 定义 方法 showDialog0， 用 于 提示 用 户 确认 是 否 移 除 或 全 部 移 除 列表 中 的 音频 文件 。 对 应 代码 如 


下 所 示 。 
private void showDialog(final String msg) { 
AlertDialog.Builder builder = new AlertDialog.Builder(this ); 
if (msg.equals("")) 
builder.setMessage ("4 8835 BR?"); 
else 
builder.setMessage(" 是 否 移 除 ?"); 
builder.setCancelable(false).setPositiveButton("", 
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new Оїаіодіпќегѓасе.ОпСііскііѕїепег() { 
public void onClick(DialogInterface dialog, int id) { 
if (msg.equals("")) 
del_All(); 
else 
del_One(selectName); 
Intent intent = new Intent(); 
setResult(6, intent); 
finish(); 


} 
}).setNegativeButton("%", new OnClickListener() ( 
@Override 
public void onClick(DialogInterface dialog, int which) { 


} 
» 
AlertDialog alert = builder.create(); 
alert.show(); 
) 
O 定义 方法 del_One() 来 删除 单 首 歌曲 ， 定 义 方法 del_All() 来 删除 全 部 歌曲 。 对 应 代码 如 下 所 示 。 
private void del_One(String musicName) {// 删 除 单 首 歌曲 
ContentResolver cr = getContentResolver(); 
Uri ип = DBProvider.CONTENT_URI; 
String where = "fileName-?"; 
String[ ] selectionArgs = { musicName }; 
cr.delete(uri, where, selectionArgs); 
} 


private void del_All() {// 删 除 全 部 歌曲 
ContentResolver cr = getContentResolver(); 
Uri uri = DBProvider. CONTENT URI; 
cr.delete(uri, null, null); 


H 
1645 ”播放 设置 界面 
本 系统 的 播放 设置 界面 如 图 16-13 所 示 。 


16-13 ”播放 设置 界面 
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(1) 编写 布局 文件 setting.xml， 主 要 代码 如 下 所 示 。 
<LinearLayout android:layout_width="fill_ parent" 

android:gravity="center" android:layout height-"wrap content" 

android:background="@drawable/footer_bar"> 

<TextView android:text=" 设 定 " android:id="@+id/setting" 
android:textSize="@dimen/music_list_title" android:layout_width="wrap_content" 
android:layout_height="wrap_content"></TextView> 

</LinearLayout> 
<LinearLayout android:orientation-"horizontal" 

android:layout_width="wrap_content" android:gravity-"center vertical" 

android:layout height-"wrap content"» 

<TextView android:text=" 播 放 模式 " android:id="@+id/setting" 
android:textSize="@dimen/text_size" android:layout_width="fill_parent" 
android:layout_height="wrap_content"></TextView> 

<RadioGroup android:id="@+id/RadioGroup" 
android:layout_width="wrap_ content" android:layout height-"wrap content"» 
«RadioButton android:text=" 单 曲 循环 " android:id="@+id/sigle_play" 

android:layout_width="wrap_content" android:layout_height="wrap_content"></RadioButton> 
«RadioButton android:text=" 顺 序 播放 " android:id="@+id/order_play" 

android:layout_width="wrap_content" android:layout_height="wrap_content"></RadioButton> 
<RadioButton android:text=" 随 机 播放 " android:id="@+id/random_play" 

android:checked="true" android:layout width="wrap content" 

android:layout_height="wrap_content"></RadioButton> 

</RadioGroup> 

</LinearLayout> 
«LinearLayout android:orientation="horizontal" 

android:layout width-"wrap content" android:gravity-"center vertical" 

android:layout height-"wrap content"» 

«TextView android:text=" 歌 词 显示 " android:id="@+id/setting" 
android:textSize="@dimen/text_size" android:layout_width="wrap_content" 
android:layout_height="wrap_content" /> 

<ToggleButton android:text="" android:id="@+id/ly_Irc" 
android:checked-"false" android:layout_width="wrap_content" 
android:layout height-"wrap content" /> 

</LinearLayout> 
«TextView android:layout_width="fill_ parent" 
android:layout_height="150px"></TextView> 
<AbsoluteLayout android:background="@drawable/footer_bar" 
android:layout_width="fill_ parent" android:layout_height="wrap_content"> 
<ImageButton android:id="@+id/make" android:background="@drawable/share" 
android:layout_x="270px" android:layout_width="wrap_content" 
android:layout height-"wrap content" /> 

<ImageButton android:id="@+id/cancel" android:layout x-"5px" 
android:background="@drawable/back" android:layout width-"wrap content" 
android:layout height-"wrap content" /> 

</AbsoluteLayout> 
(2) 编写 程序 文件 PlaySetting.java， 其 主要 功能 如 下 所 示 。 
а 设置 播放 模式 
在 设置 播放 模式 时 用 的 是 RadioGroup 组 件 ， 这 个 组 件 有 单项 选择 的 功能 ， 里面 有 RadioButton Ж, 
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多 个 RadioButton 项 只 能 同时 选中 一 个 ， 该 播放 器 播放 模式 有 单 曲 循环 、 随 机 播放 、 顺 序 播放 等 功能 。 
MediaPlayer 有 一 个 监听 器 ， 它 监听 着 歌曲 是 否 正在 播放 或 者 是 否 播放 完成 ， 当 歌曲 播放 完成 时 ， 会 触 
发 方法 OnCompletionListener()， 在 该 方法 里 面 可 以 处 理 歌 曲 播放 完成 后 的 操作 。RadioGroup 可 以 进行 


单项 选择 操作 。 

口 歌词 设置 

歌词 是 否 显 示 是 一 个 开关 按钮 ToggleButton 实现 的 ， 有 ON 和 OFF 状态 ， 当 为 ON 时 显示 歌词 ， 
为 OFF 时 关闭 歌词 。 


ToggleButton 同样 也 有 一 个 监听 器 ， 可 以 获得 ToggleButton 的 不 同 状态 。 使 用 前 对 它 进行 实例 化 
(ToggleButton) View.findViewById(R.idly_lrc); 并 且 用 ToggleButton.isChecked(); 获 得 开关 状态 。 播 放 模式 
状态 和 歌词 显示 状态 的 操作 结果 都 将 以 一 个 标志 ， 被 写 在 一 个 配置 文件 中 ， 这 是 关于 Android 的 存储 
方式 。 

了 解 文件 PlaySettingjava 的 实现 原理 和 功能 后 ， 其 实现 代码 就 非常 容易 理解 了 ， 主 要 代码 如 下 所 示 。 

protected void onCreate(Bundle savedInstanceState) ( 
super.onCreate(savedInstanceState); 
setContentView(R.layout.setting); 
set_textView = (TextView) findViewByld(R.id.setting); 
set textView.setTextColor(Color.WHITE); 
sigle Play = (RadioButton) findViewByld(R.id.sigle play); 
order Play = (RadioButton) find ViewByld(R.id.order play); 
random Play = (RadioButton) findViewByld(R.id.random play); 
lyLrc = (ToggleButton) findViewByld(R.id.ly Irc); 
set bt = (ImageButton) findViewByld(R.id.make); 
cancel bt = (ImageButton) findViewByld(R.id.cancel); 
set bt.setOnTouchListener(setting bt Listener); 
cancel bt.setOnTouchListener(cancel bt Listener); 


) 


OnTouchListener setting bt Listener = new OnTouchListener() {// 设 置 确 定 按钮 监听 器 
@Override 
public boolean onTouch(View v, MotionEvent event) { 
if (event.getAction() == MotionEvent.ACTION DOWN) { 
v.setBackgroundResource(R.drawable.share_pressed); 
SharedPreferences sp = getSharedPreferences("SET_MSG", 
MODE WORLD WRITEABLE);// 文件 共享 
SharedPreferences.Editor editor = sp.edit(); 
if (sigle Play.isChecked()) ( 
editor.putString("sigle Play", "is Sigle"); 
editor.putString("order Play", null); 
editor.putString("random Play", null); 


} 

if (order_Play.isChecked()) ( 
editor.putString("sigle Play", null); 
editor.putString("order Play", "is Order"); 
editor.putString("random Play", null); 


H 
if (random Play.isChecked()) ( 


editor.putString("sigle Play", null); 
editor.putString("order Play", null); 
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editor.putString("random_Play", "is_Random"); 


} 
if (lyLrc.isChecked()) { 
editor.putString("lyLrc", "is Show"); 


} 
if (IlyLrc.isChecked()) ( 
editor.putString("lyL rc", null); 


) 
editor.commit()// 提交 
Intent intent = new Intent(); 
setResult(4, intent); 
finish(); 
) else if (event.getAction() == MotionEvent.ACTION UP) ( 
v.setBackgroundResource(R.drawable.share); 


} 
return false; 
} 
y 
OnTouchListener cancel_bt_Listener = new OnTouchListener() {// 取消 监听 器 
@Override 


public boolean onTouch(View v, MotionEvent event) ( 

if (event.getAction() == MotionEvent.ACTION DOWN) { 
v.setBackgroundResource(R.drawable.back_pressed); 

} else if (event.getAction() == MotionEvent.ACTION UP) { 
v.setBackgroundResource(R.drawable.back); 
Intent intent = new Intent(); 
setResult(3, intent); 

finish(); 

} 


return false; 
y: 
1646 ”设置 显示 歌词 


显示 歌词 功能 比较 重要 ， 所 以 笔者 决定 单独 讲解 其 实现 原理 。 本 播放 器 的 歌词 是 .Lrc 格式 文件 ， 
查看 .Lrc 文件 中 的 歌词 格式 如 下 所 示 。 

[00:16.18] 我 爱 你 心爱 的 姑娘 

歌词 格式 是 以 “时 间 + 歌 词 ” 的 格式 存储 。 

接 下 来 将 介绍 如 何 将 .Lre 中 的 歌词 读 取出 来 并 存储 在 Android 的 配置 文件 中 。 

(1) 用 XML 配置 文件 的 存储 

在 Android 系统 中 ，SD 卡 的 目录 结构 如 图 16-14 所 示 。 

从 图 16-14 中 可 以 看 到 一 个 名 为 SDCard 的 目录 ， 该 目录 即 为 扩展 卡 ， 里 面 预先 存放 着 音频 文件 
和 .Lrc 歌词 文件 ， 我 们 定义 如 下 代码 来 指定 .Lrc 文件 存在 的 路 径 ， 并 将 文件 读 取 到 BufferReader 中 。 

BufferedReader buffer=new BufferedReader(new FileReader(new File("/sdcard/"+ musicName + ".Irc"))); 

由 于 我 们 要 分 别 存放 时 间 和 歌词 ， 所 以 应 该 定义 两 个 List<String> 容 器 来 存放 时 间 和 歌词 。 在 读 
取 .Lrc 文件 时 ， 每 次 读 取 一 行 ， 再 用 算法 将 时 间 和 歌词 分 开 后 放 到 一 个 数组 里 面 ， 并 分 别 存放 在 两 个 
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List 中 。 由 于 歌曲 在 播放 时 会 存在 界面 之 间 的 跳 转 ， 所 以 歌词 必须 固定 存放 在 一 个 文件 中 ， 而 不 能 作 
为 一 个 对 象 ， 因 此 ， 我 们 将 两 个 时 间 List 和 歌词 List 再 写 进 一 个 配置 文件 中 。 

Android 为 我 们 提供 了 共享 文件 类 SharedPreferences， 它 有 一 个 方法 getSharedPreferences( 参 数 1， 
参数 2)， 参 数 1 表示 写 进 时 的 标记 ， 便 于 在 从 其 中 读 取出 来 时 的 标记 ;参数 2 表示 读 取 模 式 ， 有 只 写 
模式 (MODE_WORLD_WRITEABLE) 和 只 读 模式 (MODE WORLD READABLE)， 在 写 之 前 将 其 
设置 为 编辑 状态 ， 下 面 是 使 用 静态 方法 设置 编辑 状态 的 代码 。 

SharedPreferences.Editor editor = sp.edit(); 

然后 在 对 象 editor 中 可 以 存 入 一 个 HashMap<key,values> 类 型 的 键 值 ， 其 格式 是 putString(KEY, 
VALUES)， 这 样 就 可 以 将 List 中 的 对 象 转化 成 一 样 长 的 字符 放 进 配置 文件 中 。 

当 写 入 成 功 时 ，Android 系统 会 自动 在 目录 data/data/ 工 程 包 名 /shared_prefs/ 中 生成 一 个 配置 文件 ， 
如 图 16-15 所 示 。 


ш @ data 


B © sdeard 
© LOST. DIR 日 包 date 
Ej Yourxin Ire @ android. tts 
B Tourxin. mp3 @ con. Rain. RSS. activity 
Ë dong. lre © com, Rain. RSS. app 
N 日 © con. Rain music. activity 
нед B) @ databases 
E) hui. mp3 - 
` B E lib 
È star dre ынан 
BB ster oo В LRC_SHOW. xnl 
_ Bowl. tet [D MUSIC. xm 
© system B SET MSG. xnl 
图 16-14 SD 卡 的 目录 结构 16-15 配置 文件 


打开 播放 模式 的 XML 配置 文件 ， 在 此 文件 中 是 以 map 的 形式 存储 的 ， 键 名 是 <string name= 
"random Play"></string>， 其 值 是 is Radom， 如 图 16-16 所 示 。 


<?xml version="1 0" encoding="utf-8" standalone="yes' ?> 
- «map» 
«string name- "random Play'»is Random «/strina» 
«string neme="lyLre">is_Show</string> 
«null neme- "order. Play" /> 
«null neme-'sigle. Play" /> 
</тар> 


16-16 XML 配置 文件 


(2) 读 取 XML 配置 文件 
我 们 仍 以 播放 模式 读 取 为 例 , 当 需 要 用 到 播放 模式 的 确定 时 将 读 取 .XML 文件 , 同样 用 共享 文件 类 
SharedPreferences 通过 用 方法 getSharedPreferences("SET MSG",MODE WORLD READABLE)， 并 且 
是 只 读 方式 获得 .XML 的 文件 内 容 。SharedPreferences 的 对 象 调用 方法 getString("sigle Play", null), 此 
方法 会 返回 一 个 String 类 型 的 值 ， 即 是 我 们 以 前 存储 进去 的 String 值 。 当 该 标记 不 存在 时 ， 会 默认 返 
回 一 个 null 值 。 读 取 XML 配置 文件 成 功 后 ， 就 可 以 根据 配置 的 值 对 程序 进行 操作 了 。 


1647 ”文件 浏览 器 模块 


本 项 目 程序 实现 了 文件 浏览 器 的 功能 ， 作 为 一 个 文件 浏览 器 应 该 具有 浏览 功能 。 当 程序 运行 到 浏 
览 界面 时 ， 会 有 各 文件 的 目录 显示 及 图 标 标识 。 从 文件 浏览 器 中 我 们 能 看 到 各 文件 ， 而 且 能 对 其 进行 
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操作 ， 本 程序 是 专 为 播放 器 添加 歌曲 而 设计 的 ， 因 此 功能 仅 限 于 对 媒体 文件 的 浏览 ， 以 及 含有 媒体 文 
件 的 目录 的 浏览 ， 所 以 功能 比较 局 限 。 

当 显示 菜单 界面 时 ， 通 过 新 增 选 项 进入 到 文件 浏览 器 中 ， 或 者 当 播放 列表 为 空 时 ， 会 提示 进入 文 
件 浏览 器 进行 歌曲 新 增 操作 。 其 中 文件 浏览 器 界面 如 图 16-17 所 示 ，SD 卡 目录 界面 如 图 16-18 所 示 。 


ы a 


/system/lostefound B isdcard/4S6.mp3 


加 ssdeard/123.mp3 


/system/xbin 


Jsystem/lib. 国 /sdcard/.android secure. 


/system/etc 国 /sdcard/LosTDIR 
16-17. 文件 浏览 器 界面 16-18 SD 卡 目录 界面 


文件 浏览 器 界面 布局 格式 类 似 前 面 介绍 的 菜单 ， 只 是 在 界面 的 第 一 行 新 增 了 一 个 返回 根 目 录 的 功 
能 。 由 于 程序 只 关系 到 目录 /sdcard 下 的 文件 ， 所 以 用 程序 屏蔽 了 其 他 的 目录 ， 这 里 只 显示 两 个 目录 
“/sdcard” 和 “/system”。 播 放 器 只 需要 用 到 媒体 文件 ， 所 以 代码 也 屏蔽 了 其 他 文件 的 子 目录 。 当 选 
中 sdcard 会 进入 到 图 16-18， 该 目录 下 只 显示 媒体 文件 ， 如 .MP3 和 SD 卡 下 的 子 目录 。 选 中 system 会 
进入 到 图 16-17， 该 目录 会 显示 system 下 的 各 级 子 目 录 。 当 有 媒体 文件 时 才 会 出 现 添加 Dialog。 

当 要 添加 选中 的 歌曲 时 ， 程 序 有 自动 判断 功能 ， 首 先 弹出 Dialog。 单 击 “ 确 定 ” 按 钮 后 ， 程 序 会 
查询 数据 库 中 的 歌曲 ， 调 用 方法 query(fileName)， 根 据 歌 曲名 字 查 询 ， 如 果 歌 曲 不 存在 ， 则 调用 方法 
insertMusic(file)， 如 果 该 歌曲 名 字 已 经 存在 则 弹出 Dialog 对 话 框 。 

(1) 编写 文件 directory listxml， 实 现 文件 浏览 界面 的 布局 ， 主 要 代码 如 下 所 示 。 

«LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 

android:orientation="vertical" android:layout_width="fill_parent" 
android:layout_height="fill_ parent" android:background="@drawablellist_bg"> 
«LinearLayout android:layout_width="fill_ parent" 
android:gravity="center" android:layout height-"wrap content" 
android:background-"(Qdrawable/footer bar"» 
<TextView android:text-" SD +" android:id-"(g)*id/store card" android:textStyle="bold" 
android:layout width-"wrap content" android:layout height-"wrap content" 
android:textSize="@dimen/music list title"» «/TextView» 
</LinearLayout> 


«ListView android:id="@id/android:list" android:layout width-"wrap content" 
android:layout height-"wrap content" /> 
«TextView android:layout_width="10px" 
android:layout height-"wrap content" /> 
«TextView android:id="@id/android:empty" android:layout width-"wrap content" 
android:layout height-"wrap content" android:text="@string/no_files" 
> 
(2) 编写 文件 FileExplorerActivityjava， 在 此 定义 了 文件 浏览 器 类 FileExplorerActivity, Ж ЖК 
了 ListActivity, 此 Activity 是 一 个 ListView 界面 .整个 界面 是 一 个 ListView 布局 ,而 每 一 行 是 一 个 Linear- 


Layout 水 平方 式 布局 ， 上 面 将 放置 一 个 图 片 和 一 个 文件 全 路 径 。 该 文件 全 路 径 被 存放 到 数据 库 中 ， 以 
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便 歌曲 播放 能 查询 到 歌曲 路 径 源 。 
文件 FileExplorerActivity.java 的 主要 代码 如 下 所 示 。 
public class FileExplorerActivity extends ListActivity { 
private List<String> items = null; 
private TextView store_Card; 
@Override 
public void onCreate(Bundle icicle) { 
super.onCreate(icicle); 
setContentView(R.layout.directory list); 
store Card = (TextView) findViewByld(R.id.store сага); 
store Card.setTextColor(Color. WHITE); 
fill(new File("/").listFiles()); 
} 


@Override 
protected void onListltemClick(ListView |, View v, int position, long id) { 
int selectionRowID = (int) position; 
File file = new File(items.get(selectionRowID)); 
if (selectionRowID == 0) { 
fillWithRoot(); 
) else { 
if (file.isDirectory()) ( 
fill(file.listFiles()); 
) else ( 
Intent intent = this.getlntent(); 
intent.putExtra("filePath", file); 
FileExplorerActivity.this.setResult(0, intent); 
showDialog(" 加 入 播放 列表 ?", file); 


} 


private void fillWithRoot() { 
fill(new File("/").listFiles()); 
} 


private void fill(File[ ] files) ( 
items = new ArrayList<String>(); 
items.add(getString(R.string.to_top)); 
for (File file : files) { 
if (file.isDirectory()) { 
if ((file.getPath().indexOf("/sdcard")) != -1 
|| (file.getPath().indexOf("/system")) {= -1) 


items.add(file.getPath()); 
} 
if ((file.getPath().indexOf(".mp3")) (= -1) ( 
items.add(file.getPath()); 
} 


} 
setListAdapter(new MusicAdapter(this, items)); 
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} 


private void showDialog(String msg, final File file) { 
AlertDialog.Builder builder = new AlertDialog.Builder(this); 
builder.setMessage(msg).setCancelable(false).setPositiveButton(" ffe ", 
new Dialoginterface.OnClickListener() { 
public void onClick(DialogInterface dialog, int id) { 
String fileName = file.getName().substring(0, 
file.getName().indexOf(".")); 
Log.i("info", fileName); 


if (query(fileName)) ( 
insertMusic(file);// 添 加 音乐 
} 
} 
}).setNegativeButton(" 取 消 ", null); 
AlertDialog alert = builder.create(); 
alert.show(); 
} 
l 添加 音乐 到 播放 列表 


private final void insertMusic(File file) { 
ContentResolver cr = getContentResolver(); 
ContentValues values = new ContentValues(); 
Uri uri = DBProvider.CONTENT_URI; 
String fileName = file.getName().substring(0, 
file.getName().indexOf(".")); 
values.put(FileColumn.NAME, fileName); 
values.put(FileColumn.PATH, file.getAbsolutePath()); 
values.put(FileColumn.TYPE, "Music"); 
values.put(FileColumn.SORT, "popular"; 
cr.insert(uri, values); 
Toast.makeText(FileExplorerActivity.this, "已 加 入 ", Toast.LENGTH LONG) 
.Show(); 
Intent intent = new Intent(); 
setResult(6, intent); 
finish(); 
} 


private boolean query(String name) { 
ContentResolver cr = getContentResolver(); 
Uri uri = DBProvider. CONTENT URI; 
String[ ] projection = ( "filename" }; 
Cursor c = cr.query(uri, projection, null, null, null); 
if (c. moveToFirst()) ( 
for (int i = 0; i < c.getCount(); i++) ( 
c.moveToPosition(i); 
String filename DB - c.getString(0); 
if (name.equals(filename DB)) {/ 判 断 播放 列表 中 是 否 存在 该 歌曲 
AlertDialog.Builder builder = new AlertDialog.Builder(this); 
builder.setMessage(" 文 件 已 存在 ").setCancelable(false) 
.setPositiveButton(" 返 回 列表 ", 
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new DialogInterface.OnClickListener() { 
public void onClick( 
Dialoginterface dialog, int id) { 
Intent intent = new Intent( 
FileExplorerActivity.this, 
PlayListActivity.class); 
startActivity(intent); 


} 
}).setNegativeButton(" ЖЛ", null); 
AlertDialog alert = builder.create(); 
alert.show(); 
retum false; 
} 
} 
} 


return true; 
} 
ӘЖ ListView 实现 了 自动 判断 的 功能 ， 即 程序 可 以 通过 访问 扩展 卡 中 的 文件 属性 而 自动 识别 文件 
属性 。 当 为 一 个 MP3 格式 文件 时 ， 则 前 面 图 标 显示 MP3 图 标 ， 当 为 一 个 文件 目录 时 ， 则 图 标 标识 为 
一 个 文件 。 文 件 浏览 器 是 用 递归 算法 实现 的 ， 其 中 fillWithRoot0 用 于 返回 根 目录 的 列表 。 


16.4.8 ”数据 存储 


在 播放 器 正常 运行 时 ， 由 于 各 界面 存在 相互 跳 转 ， 为 了 避免 数据 在 界面 跳 转 的 过 程 中 丢失 ， 我 们 
需要 将 一 些 数据 进行 临时 存储 或 者 永久 存储 。 

Android 作为 一 种 手机 操作 系统 ， 提 供 了 Preference (配置)、File (文件 )、SQLite 数据 和 网 络 等 
存 取 数据 的 方式 。 

У, ТЕ Android 中 各 个 应 用 程序 组 件 之 间 是 相互 独立 的 ， 彼 此 的 数据 不 能 共享 。 为 了 实现 数据 
的 共享 ，Android 提供 了 Content Provider 组 件 来 实现 应 用 程序 之 间 数 据 的 共享 。 

(1) SharedPreferences 

SharedPreference 提供 了 一 种 轻 量 级 的 数据 存 取 方法 ， 通 常用 于 存储 数据 比较 少 的 信息 或 一 些 简单 
的 配置 信息 。 它 以 “ 键 - 值 ”( 是 一 个 Map) 对 的 方式 ， 将 数据 保存 在 一 个 XML 配置 文件 中 。 

在 本 实例 中 用 到 了 如 下 两 种 数据 存储 接口 。 

Q  android.content.SharedPreferences: 提供 了 保存 数据 的 方法 。 

口 android.content.SharedPreferences.Editor: 提供 了 获得 数据 的 方法 。 


注意 : 有 关上 述 SharedPreferences 数 据 存储 的 知识 ， 请 读者 参阅 相关 资料 ， 这 并 不 是 本 书 的 重点 。 


以 播放 器 中 的 播放 模式 存 取 为 例 ， 实 现 流程 如 下 。 

口 XML 配置 文件 的 读 取 

仍 以 播放 模式 读 取 为 例 ， 当 需要 用 到 播放 模式 的 确定 时 ,我 们 将 读 取 .XML 文件 ， 同 样 用 共享 文件 
类 SharedPreferences, 通过 用 方法 getSharedPreferences("SET_MSG",MODE_WORLD_READABLE), 并 
且 是 只 读 方式 获得 XML 的 文件 内 容 。SharedPreferences 的 对 象 调用 方法 getString("sigle Play", null), 
方法 返回 一 个 String 类 型 的 值 ， 即 是 我 们 以 前 存储 进去 的 String 值 。 此 方法 当 该 标记 不 存在 时 会 默认 
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返回 一 个 null 值 。 获 得 成 功 后 我 们 就 可 以 运用 当前 的 值 再 对 程序 进行 操作 了 。 
口 XML 配置 文件 的 存储 
在 类 SharedPreferences 中 有 一 个 方法 getSharedPreferences( 参 数 1， 参 数 2)， 参 数 1 为 写 进 时 的 标 
记 , 便 于 在 从 其 中 读 取出 来 时 的 标记 , 参数 2 为 读 取 模式 , 有 只 写 模 式 (MODE_ WORLD_WRITEABLE) 
和 只 读 模式 (MODE WORLD READABLE )， 在 写 之 前 将 其 置 入 编辑 状态 ， 用 静态 方法 Shared- 
Preferences.Editor editor = sp.edit(); 然后 对 象 editor 可 以 存 入 一 个 HashMap<key,values> 类 型 的 键 值 ， 即 
putString(KEY, VALUES)， 这 样 ， 我 们 可 以 将 List 中 的 对 象 转化 成 一 样 长 的 字符 放 进 配置 文件 中 。 当 写 
入 成 功 时 ，Android 系统 会 自动 在 目录 data/data/ 工 程 包 名 /shared_prefs 下 生成 一 个 配置 文件 。 
(2) File 存储 方式 
我 们 可 以 将 一 些 数据 直接 以 文件 的 形式 保存 在 设备 中 。 例 如 一 些 文 本 文件 、PDF 文件 、 音 视频 文 
件 和 图 片 等 。Android 提供 了 如 下 文件 读 写 的 方法 。 
O Context.openFileInput(): 获得 标准 Java 文 件 输入 流 (FilelnputStream) 。 
口 Context.openFileOutput(): 获得 标准 Java 文 件 输出 流 (FileOutputStream ) 。 
O Resources.openRawResource (R.raw.myDataFile): 返回 InputStream。 
(3) SQLiteDatabase 数据 库 
SQLite 是 一 个 嵌入 式 数据 库 引擎 ， 针 对 内 存 等 资源 有 限 的 设备 〈 如 手机 、PDA、MP3) 提供 的 一 
种 高 效 的 数据 库 引擎 。SQLite 数据 库 不 像 其 他 的 数据 库 ( 例 如 Oracle)， 它 没有 服务 器 进程 ， 所 有 的 内 
容 包 含 在 同一 个 单 文件 中 ， 该 文件 是 跨 平台 的 可 以 自由 复制 。 基 于 其 自身 的 先天 优势 ，SQLite ERA 
式 领 域 得 到 了 广泛 应 用 。 
口 SQLiteDatabase 类 : 代表 一 个 数据 库 对 象 ， 在 里 面 提供 了 操作 数据 库 的 一 些 方法 ， 具 体 方法 请 读 
者 参考 相关 教材 或 书籍。 
O SQLiteOpenHelper 类 : 是 SQLiteDatabase 的 一 个 帮助 类 ， 用 来 管理 数据 库 的 创建 和 版 本 更 新 。 一 
般 的 用 法 是 定义 一 个 类 继承 之 ， 并 实现 其 两 个 抽象 方法 onCreate(SQLiteDatabase db) 和 
onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) 来 创建 和 更 新 数据 库 。 
Android 的 3 种 数据 存储 方式 则 让 我 们 可 以 轻松 方便 地 进行 程序 编写 和 数据 的 访问 , 更 不 会 让 不 该 
消失 的 数据 消失 ， 这 对 我 们 进行 程序 书写 有 很 大 的 帮助 。 
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RSS 是 在 线 共享 内 容 的 一 种 简易 方式 (也 叫 聚 合 内 容 ，Really Simple Syndication)。 通 常 在 时 效 性 
比较 强 的 内 容 上 使 用 RSS 订阅 能 更 快速 获取 信息 ， 网 站 提供 RSS 输出 ， 有 利于 让 用 户 获取 网 站 内 容 的 
最 新 更 新 。 在 本 书 前 面 的 内 容 中 ， 已 经 讲解 过 一 个 简单 RSS 系统 的 实现 流程 ， 本 章 将 通过 一 个 综合 实 
例 的 实现 过 程 ， 详 细 讲 解 在 Android 手机 中 开发 一 个 RSS 阅读 器 的 方法 。 
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М 知 识 点 讲解 光盘 :视频 \ 知 识 点 \ 第 17 章 \ 实 现 流程 .avi 

本 项 目 实例 的 功能 是 ， 在 手机 中 显示 指定 RSS 的 信息 ， 即 设置 显示 网 易 博客 http://woshiyigebing 
12345.blog.163.com 用 户 的 日 志 信息 。 

本 项 目的 具体 实现 流程 如 图 17-1 所 示 。 
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17-1 实现 流程 图 
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GH 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 17 章 \ 具 体 实现 .avi 
从 本 节 内 容 开 始 ， 将 着 重 介绍 本 项 目的 具体 实现 过 程 ， 以 及 各 个 代码 的 具体 实现 过 程 ， 并 讲解 其 
中 的 技巧 和 要 点 ， 使 读者 的 水 平 更 上 一 层 楼 。 
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17.2.1 建立 实体 类 


一 个 RSS 文件 可 以 被 认为 是 由 一 个 RSS 的 一 些 描述 性 信息 和 里 面 的 item 元 素 组 成 的 ， 例 如 关于 
RSS 的 描述 性 信息 如 下 。 

О title: 标题 信息 。 

Q link: 链接 信息 。 

口 description: 描述 信息 。 

item 里 的 信息 如 下 。 

О ше: 标题 信息 。 

口 link: 链接 信息 。 

Q description: 描述 信息 。 

O pubDate: 发 布 的 日 期 。 

在 本 项 目 实例 中 需要 建立 如 下 两 个 实体 类 。 

口 RSSFeed: 用 于 和 一 个 RSS 的 完整 XML 文 件 相 对 应 。 

O RSSItem: 用 于 和 一 个 RSS 中 Item 标 签 相对 应 。 

在 解析 RSS 文件 时 ， 可 以 将 文件 里 的 信息 解析 出 来 放 到 实体 类 里 ， 这 样 就 可 以 直接 操作 该 实体 类 
了 。 下 面 开始 讲解 上 述 两 个 实体 类 的 具体 实现 过 程 。 


1.RSSFeed 类 


RSSFeed 类 的 功能 是 建立 和 一 个 完整 XML 文件 的 对 应 ， 其 中 方法 addItem() 用 于 将 一 个 RSSItem 
添加 到 RSSFeed 类 里 ; 方法 getAllItemsForListView() fi 7t RSSFeed 类 里 生成 ListView 列表 所 需要 的 


数据 。RSSFeed 类 的 具体 实现 代码 如 下 所 示 。 
package com.rss_reader.data; 
import java.util. ArrayList; 
import java.util. HashMap; 
import java.util.List; 
import java.util.Map; 
import java.util. Vector; 


T 


public class RSSFeed 

( 
private String title = null; 
private String pubdate = null; 
private int itemcount = 0; 
private List<RSSltem> itemlist; 


public RSSFeed() 
{ 
itemlist = new Vector(0); 
} 
public int addltem(RSSltem item) 
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@ 


£ 
itemlist.add(item); 
itemcount++; 
return itemcount; 
) 
public RSSItem getltem(int location) 
{ 
return itemlist.get(location); 
} 
public List getAllltems() 
{ 
return itemlist; 
} 


public List getAllltemsForListView(){ 
List<Map<String, Object>> data = new ArrayList<Map<String, Object>>(); 
int size = itemlist.size(); 
for(int i=0;i<size;i++){ 
HashMap<String, Object> item = new HashMap<String, Object>(); 
item.put(RSSltem.TITLE, itemlist.get(i).getTitle()); 
item.put(RSSltem.PUBDATE, itemlist.get(i).getPubDate()); 


data.add(item); 

) 

return data; 
) 
int getltemCount() 
{ 

return itemcount; 
} 
public void setTitle(String title) 
{ 

this.title = title; 
} 
public void setPubDate(String pubdate) 
{ 

this.pubdate = pubdate; 
} 
public String getTitle() 
{ 

return title; 
} 
public String getPubDate() 
{ 

return pubdate; 
} 
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2. RSSltem 类 


RSSFeed 类 用 于 和 一 个 RSS 中 的 Item 标签 相对 应 ， 它 里 面 的 属性 和 item 里 面 的 属性 一 样 。 
RSSItem 类 的 具体 实现 代码 如 下 所 示 。 


package com.rss_reader.data; 


public class RSSItem 
{ 
public static final String TITLE="title"; 
public static final String PUBDATE-"pubdate"; 
private String title = null; 
private String description = null; 
private String link = null; 
private String category = null; 
private String pubdate = null; 


public RSSItem() 


{ 
} 
public void setTitle(String title) 
{ 
this.title = title; 
} 
public void setDescription(String description) 
{ 
this.description = description; 
} 
public void setLink(String link) 
{ 
this.link = link; 
} 
public void setCategory(String category) 
{ 
this.category = category; 
} 
public void setPubDate(String pubdate) 
{ 
this.pubdate = pubdate; 
} 
public String getTitle() 
{ 
return title; 
} 
public String getDescription() 
í 
return description; 
) 
public String getLink() 
{ 
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return link; 


} 
public String getCategory() 


{ 
return category; 
} 
public String getPubDate() 
{ 
return pubdate; 


} 
public String toString() 


if (title length() > 20) 


{ 

return title.substring(0, 42) + "..."; 
} 
return title; 


} 


17.2.2 主 程 序 文件 ActivityMain.java 


主 程序 文件 ActivityMain java 是 本 项 目的 入 口 ,在 此 Activity 中 得 到 了 服务 器 端的 RSSFeed, 经 过 


解析 后 将 里 面 的 内 容 以 ListView 的 形式 显示 出 来 。 下 面 开始 讲解 其 具体 实现 流程 。 


(1) 先 引入 相关 class 类 ， 然 后 设置 目标 RSS 的 源 地 址 为 http://feed.feedsky.com/woshiyigebing12345， 


最 后 通过 showListView() 方 法 将 获取 的 RSS 信息 以 列表 形式 显示 出 来 。 具 体 代码 如 下 所 示 。 


530 


package com.rss_reader; 
import java.net.URL; 


import javax.xml.parsers.SAXParser; 
import javax.xml.parsers.SAXParserFactory; 


import org.xml.sax.InputSource; 
import org.xml.sax.XMLReader; 


import android.app.Activity; 

import android.content.Intent; 

import android.os.Bundle; 

import android.view.View; 

import android.widget.AdapterView; 

import android.widget.ListView; 

import android.widget.SimpleAdapter; 

import android.widget.AdapterView.OnltemClickL istener; 


import com.rss reader.data.RSSFeed; 
import com.rss_reader.data.RSSltem; 
import com.rss_reader.sax.RSSHandler; 
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public class ActivityMain extends Activity implements OnltemClickListener 


{ 
|| public final String RSS URL = "“http://rubyjin.cn/blog/rss"; 


public final String RSS URL =" http://feed.feedsky.com/woshiyigebing1 2345"; 


public final String tag = "RSSReader"; 
private RSSFeed feed = null; 


/** Called when the activity is first created. */ 


public void onCreate(Bundle icicle) ( 
super.onCreate(icicle); 
setContentView(R.layout.main); 
feed = getFeed(RSS URL); 
showListView(); 


) 

(2) 定义 方法 getFeed(String urlString)， 用 于 得 到 一 个 RSSFeed， 即 从 服务 器 端 请 求 RSS feed, 并 
进行 了 解析 ,将 解析 后 的 内 容 都 放 在 RSSFeed 的 一 个 实例 里 。 上 述 解析 过 程 是 通过 SAX 实现 的 , 具体 
流程 如 下 。 

О 第 一 步 : 新 建 工厂 类 SAXParserFactory。 

О 第 二 步 : 工厂 类 产 出 一 个 SAX 和 解析 类 SAXParser。 

О 第 三 步 : 从 SAXParser 中 得 到 一 个 XMLReader 实 例 ，XMLReader 是 一 个 接口 ， 此 接口 中 定义 了 一 
些 解析 XML 的 回调 函数 。 

О 第 四 步 : 把 编写 的 Handler 注 册 到 XMLReader 中 去 。 

OQ 第 五 步 : 将 一 个 XML 文 档 或 资源 变 成 一 个 Java 可 以 处 理 的 InputStream 流 后 ， 解 析 工 作 开始 。 

方法 getFeed(String urlString) 的 具体 代码 如 下 所 示 。 

private RSSFeed getFeed(String urlString) 

{ 


try 
{ 
URL url = new URL(urlString); 
/* 新 建 工 厂 类 SAXParserFactory*/ 
SAXParserFactory factory = SAXParserFactory.newinstance(); 
/工厂 类 产 出 一 个 SAX 解析 类 SAXParser */ 
SAXParser parser = factory.newSAXParser(); 
У SAXParser 中 得 到 一 个 XMLReader 实例 */ 
XMLReader xmlreader = parser.getXMLReader(); 
/把 编写 的 Handler 注册 到 XMLReader 中 */ 
RSSHandler rssHandler = new RSSHandler(); 
xmlreader.setContentHandler(rssHandler); 


/将 一 个 XML 文档 或 资源 变 成 一 个 Java 可 以 处 理 的 InputStream 流 后 ， 解 析 工 作 开 始 */ 
InputSource is = new InputSource(url.openStream()); 


O 
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xmlreader.parse(is); 
return rssHandler.getFeed(); 


} 
catch (Exception ee) 
{ 


return null; 
} 
} 
G) 定义 方法 showListView() 来 列表 显示 获取 的 RSS, XXE ListView 和 一 个 SimpleAdapter 实现 
了 绑 定 。 有 具体 代码 如 下 所 示 。 


private void showListView() 
{ 
ListView itemlist = (ListView) findViewByld(R.id.itemlist); 
if (feed == null) 
{ 
setTitle(" 访 问 的 RSS ЖЖ"); 
return; 
} 


SimpleAdapter adapter = new SimpleAdapter(this, feed.getAllltemsForListView(), 
android.R.layout.simple list item 2, new String[ ] { RSSltem.TITLE,RSSItem.PUBDATE }, 
new іпі{ ] ( android.R.id.text1 , android.R.id.text2}); 

itemlist.setAdapter(adapter); 

itemlist.setOnltemClickListener(this); 

itemlist.setSelection(0); 


) 
(4) 定义 方法 onItemClick0， 用 于 处 理 列 表 的 单 击 事件 ， 当 单 击 后 会 显示 此 RSS 信息 的 链接 地 址 ， 
用 户 单 击 后 可 以 通过 浏览 器 来 到 目标 地 址 。 有 具体 代码 如 下 所 示 。 
public void onltemClick(AdapterView parent, View v, int position, long id) 
{ 


Intent itemintent = new Intent(this,ActivityShowDescription.class); 


Bundle b = new Bundle(); 

b.putString("title", feed.getltem(position).getTitle()); 
b.putString("description", feed.getltem(position).getDescription()); 
b.putString("link", feed.getltem(position).getLink()); 
b.putString("pubdate", feed.getltem(position).getPubDate()); 


itemintent.putExtra("android.intent.extra.rssltem", b); 


startActivityForResult(itemintent, 0); 
} 


17.2.3 ”实现 ContentHandler 


ContentHandler 是 一 个 特殊 的 SAX 接口 ， 位 于 org.xml.sax.ContentHandler。 在 我 们 解析 XML 时 ， 
大 多 数 步骤 都 是 固定 不 变 的 , 但 是 关于 ContentHandler 的 实现 却 是 不 同 的 。 实现 ContentHandler 是 解析 


@ 


XML Н 


和 要、 最 关键 的 步骤 之 一 ， 下 面 将 开始 讲解 其 具体 实现 流程 。 
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СТ) 声明 RSSHandler 类 ， 声 明 继承 于 DefaultHandler 的 类 。DefaultHandler 类 是 一 个 基 类 ， 此 类 


um 


package com.rss_reader.sax; 


import org.xml.sax.Attributes; 
import org.xml.sax.SAXException; 
import org.xml.sax.helpers.DefaultHandler; 


import android.util.Log; 


import com.rss_reader.data.RSSFeed; 
import com.rss_reader.data.RSSItem; 


public class RSSHandler extends DefaultHandler 


{ 


(2) 233 


RSSFeed rssFeed; 

RSSltem rssltem; 

String lastElementName = ""; 
final int RSS_TITLE = 1; 

final int RSS_LINK = 2; 

final int RSS_DESCRIPTION = 3; 
final int RSS_CATEGORY = 4; 
final int RSS PUBDATE = 5; 


int currentstate = 0; 


public RSSHandler() 
{ 
} 


public RSSFeed getFeed() 


{ 
return rssFeed; 


} 


简单 实现 了 一 个 ContentHandler， 只 需 重 写 里 面 的 重要 方法 即 可 。 具 体 代 码 如 下 所 示 。 


E startDocument() 和 endDocument()， 通 常 将 正式 解析 前 的 初始 化 工作 放 到 start 


Document(0 中 ， 将 一 些 收尾 性 工作 放 到 endDocument0 中 。 有 具体 代码 如 下 所 示 。 


public void startDocument() throws SAXException 


{ 


rssFeed = new RSSFeed(); 
rssltem = new RSSItem(); 


public void endDocument() throws SAXException 


{ 
} 
G) 


数 内 部 通 


重 写 startElement， 当 XML 解析 器 遇 到 XML 文档 流 里 的 tag 时 ， 将 会 调用 此 函数 。 在 此 函 
常 是 通过 参数 localName 进行 判断 并 进行 一 些 操作 处 理 的。 具体 代码 如 下 所 示 。 


Android 外 设 开发 实战 


public void startElement(String namespaceURI, String localName,String qName, Attributes atts) throws 


SAXException 
{ 

if (localName.equals("channel")) 

{ 
currentstate = 0; 
return; 

} 

if (localName.equals("item")) 

{ 
rssltem = new RSSltem(); 
return; 

) 

if (localName.equals("title")) 

( 
currentstate = RSS TITLE; 
return; 

) 

if (localName.equals("description")) 

{ 
currentstate = RSS_DESCRIPTION; 
return; 

) 

if (localName.equals("link")) 

{ 
currentstate = RSS_LINK; 
return; 

} 

if (localName.equals("category")) 

{ 
currentstate = RSS_CATEGORY; 
return; 

} 

if (localName.equals("pubDate")) 

{ 
currentstate = RSS PUBDATE; 
return; 

} 

currentstate = 0; 


(4) j endElement, ЈГ startElement 方法 相对 应 ， 当 解析 tag 完毕 后 执行 此 方法 。 如 果 


解析 一 个 item 节点 结束 ， 就 将 RSSItem 添加 到 RSSFeed 中 。 有 具体 代码 如 下 所 示 。 
public void endElement(String namespaceURI, String localName, String qName) throws SAXException 
{ 


/| 如 果 解 析 一 个 item 节点 结束 ， 就 将 RSSltem 添加 到 RSSFeed 中 
if (localName.equals("item")) 


{ 


e 


rssFeed.addltem(rssltem); 
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return; 


} 
} 
(5) 重 写 characters() 方 法 ， 此 方法 是 一 个 回调 方法 ， 当 解析 完 startElement() 方 法 后 ， 解 析 完 节点 
内 容 后 会 执行 此 方法 ， 并 且 参 数 ch[ ] 就 是 节点 的 内 容 。 有 具体 代码 如 下 所 示 。 
public void characters(char ch[ ], int start, int length) 
{ 


String theString = new String(ch,start,length); 
switch (currentstate) 


case RSS_TITLE: 
tssitem.setTitle(theString); 
currentstate = 0; 
break; 

case RSS_LINK: 
rssltem.setLink(theString); 
currentstate = 0; 
break; 

case RSS DESCRIPTION: 
rssitem.setDescription(theString); 
currentstate = 0; 
break; 

case R88 CATEGORY: 
rssltem.setCategory(theString); 
currentstate = 0; 
break; 

case RSS PUBDATE: 
rssltem.setPubDate(theString); 
currentstate = 0; 
break; 

default: 
return; 


) 
17.2.4” 主 程序 文件 ActivityShowDescription.java 


主 程序 文件 ActivityShowDescription.java 的 功能 是 显示 某 列表 信息 的 详细 信息 。 当 单 击 列表 中 的 某 
一 项 后 会 进入 到 此 界面 。 如 果 程 序 出 错 ， 则 content 显示 出 错 提 示 ; 如 运行 正确 则 在 content 中 分 别 显 
示 title, pubdate 和 description。 具 体 代码 如 下 所 示 。 

package com.rss_reader; 


import android.app.Activity; 
import android.os.Bundle; 
import android.widget.Button; 


Android 外 设 开发 实战 


import android.widget.TextView; 
import android.content. Intent; 
import android.view.*; 


public class ActivityShowDescription extends Activity { 
public void onCreate(Bundle icicle) { 
super.onCreate(icicle); 
setContentView(R.layout.showdescription); 
String content = null; 
Intent startingIntent = getintent(); 


if (startingIntent != null) { 
Bundle bundle = startingIntent 
.getBundleExtra("android.intent.extra.rssltem"); 
if (bundle == null) ( 
content = "PF EB РЕН san"; 
) else { 
content = bundle.getString("title") + "nin" 
+ bundle.getString("pubdate") + "unin" 
+ bundle.getString("description").replace(^n', ' ') 
+ "nn 详细 信息 请 访问 以 下 网 址 \n" + bundle.getString("link"); 
} 
) else { 


content = "不 好 意思 程序 出 错 啦 "; 
} 


TextView textView = (TextView) findViewByld(R.id.content); 
textView.setText(content); 


Button backbutton = (Button) findViewByld(R.id.back); 


backbutton.setOnClickListener(new Button.OnClickListener() { 
public void onClick(View v) { 


finish(); 
} 
}; 
} 
} 
17.2.5 主 布局 文件 main.xml 
主 布局 文件 main.xml 用 于 定义 系统 初始 主 界面 , 即 列表 显示 获取 的 RSS 信息 。 具 体 代码 如 下 所 示 。 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 
<ListView 


6. 
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android:layout_width="fill_ parent" 
android:layout_height="fill_ parent" 
android:id="@+id/itemlist" 


> 
</LinearLayout> 


17.2.6 详情 主 布局 文件 showdescription.xml 


当 用 户 单 击 列表 信息 后 ， 会 进入 信息 详情 界面 ， 此 界面 是 由 布局 文件 showdescription.xml 定义 的 。 
具体 代码 如 下 所 示 。 

<?xml version="1.0" encoding="utf-8"?> 

«LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="fill_parent" 
android:layout height="fill parent" 
> 

<TextView 
android:layout width="fill parent" 
android:layout_height="wrap_content" 
android:autoLink="all" 
android:text="" 
android:id="@+id/content" 
android:layout_weight="1.0" 
> 

<Button 
android:layout_width="fill_ parent" 
android:layout_height="wrap_content" 
android:text=" 返 回 " 

android:id="@+id/back" 

> 


eifinealEayonte 
至 此 ， 整 个 实例 介绍 完毕 。 运 行 后 将 获取 指定 RSS 中 的 信息 ， 如 图 17-2 所 示 。 单 击 某 条 信息 后 会 
显示 此 信息 的 相关 描述 性 信息 ， 如 图 17-3 所 示 。 


1918: 


世界 杯 之 夏 


Tue, 15 Jun 2010 10:36:10 +0800 


9 172 初始 效果 图 17-3 详情 界面 
单 击 图 17-3 中 的 链接 后 ， 能 够 显示 此 条 RSS 的 详细 信息 ， 如 图 17-4 所 示 。 


537 


本 实例 默认 显示 的 是 博客 http://woshiyigebing12345.blog.163.com/ 中 的 信息 。 读 者 也 可 以 指定 显示 其 
他 RSS 信息 ， 在 使 用 时 可 以 登录 http:/wwwfeedsky.com/ 来 设置 不 同 的 RSS 订阅 。 具 体 设 置 流程 如 下 。 
(1) 来 到 http://www.feedsky.com/ 主 界面 ， 如 图 17-5 所 示 。 


FeedSky*# 强大 完善 的 Feed 添 如、 发行、 管理 、 统 计 服务 
desea 


ТЮШ MY 8 оос Эшке айт BH 


请 输入 你 的 博客 (Bl0g1 或 Feed 地 址 : 


шышт € 


= кып 轻松 获得 
= 广告 收入 
DELIS 


图 17-5  feedsky.com 主 界面 
(2) 在 图 17-5 顶部 的 文本 框 中 输入 要 显示 信息 的 博客 地 址 、Feed 地 址 或 QQ 号 码 , 然后 单 击 “ 下 
一 步 ” 按 钮 ， 如 图 17-6 所 示 。 


@ 
feedSky*ë 强大 完善 的 Feed 添 加 、 发 行 、 管 理 、 统 计 服务 


www.feedsky.com изгоесввюся E E 


请 输入 你 的 博客 (Blog) 或 Feed 地 址 : 
зано 


图 17-6 输入 设置 的 博客 、QQ 或 Feed 地 址 
G) 在 弹出 界面 中 分 别 输入 名 称 、 描 述 和 Tag 的 信息 ,并 设 定 永久 性 Feed 地 址 ， 如 图 17-7 所 示 。 


@ 


17-7 添加 Feed 界面 


图 17-7 中 的 永久 Feed 地 址 就 是 RSS 的 源 地 址 ， 这 样 就 可 以 将 此 地 址 添加 到 实例 中 ， 
地 址 的 RSS 资源 信息 ， 也 就 是 显示 博客 http://woshiyigebing12345.blog.163.com/ 中 的 信息 。 
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ШЫ 知识 点 讲解 光盘 :视频 \ 知 识 点 \ 第 17 章 \ 打 包 、 签 名 和 发 布 .avi 
当 一 个 Android 项 目 开发 完毕 后 ， 需 要 打包 和 签名 处 理 ， 这 样 才能 放 到 手机 中 使 用 ， 
发 布 到 Market 上 去 赚钱 。 下 面 开 始 讲解 打包 、 签 名 、 发 布 Android 程序 的 具体 过 程 。 


17.3.1 申请 会 员 


即 去 Market 申请 成 为 会 员 ， 具 体 流程 如 下 : 
СТ) 登录 http://market.android/publish/signup， 如 图 17-8 所 示 。 


Distribute your applications to users of Android mobile phones. 


бирме thai pphratione есут Google Ассо 


em zem 
图 17-8 登录 Market 


从 而 显示 此 


当然 也 可 以 


(2) 单 击 链接 Create an account now， 来 到 注册 页 面 ， 如 图 17-9 所 示 。 


XEO ЖЕШ $50 ALO SEG IAD Bw 


Qc x a x 


Ü v @enxmems $ 代用/ 中 国 o SERE фатін o RAE 


Create an Account 


Your Google Acccunt gives you access to Android Market Publisher Site and other Google seces. If ycu already have 
а Google Account, you can sign in here, 


Required information for Google account 


Your current email address: 


e.g mynrama@examole.com. This will be used to sign-in to your 
account. 


Choose a password: Password strength 
Minimum of8 characters n length. 


V 


É Stay signed in 


Creating a Google Account wil enable Web History. Web History is а 
feature that will provide you with a more personalized experience on 
Google that includes more relevant search results and 
recommendations. Leam More 


Enable Web History. 


Get started with Android Market Publisher Site 


China (中 国 ) z] 
азме | 


Location 


图 17-9 注册 界面 
(3) 单 击 同意 协议 后 来 到 下 一 步 页 面 ， 在 此 输入 手机 号 码 ， 如 图 17-10 所 示 。 


‘Account verficaticn helps wih 


© Proventirg spam we try to verify that real people, го! robots, ae creating accounts. 

© Recovering account access: we wil use your information to verfy your identity f you ever lose 
access to your account. 

© Communication: we wil use your information to notify you of important changes to your accourt 
(от example, password changes from а new location) 


Unless you explicitly tell us to do so, your phone number will never be sold or shared with 
other companies, and we will not use it for any purpose other than during this verification step 
and for password recovery and account security issues. ln other words, you dont have to моту 
about getting spam calls or text messages тот us, ever. 


For more information, please read our frequently asked questions. 


Verification Options 


€ Text Message 

Google vill send a text message containing a verification cade to your mobile phone. 
© Voice Call 

Google vill make an automated voice call to уси phone with a veriication code. 


Country 


China (PE) 3 


Mobile phone number 
LI 
E 


图 17-10 输入 手机 号 码 
(4) 在 新 界面 中 输入 手机 获取 的 验证 码 ， 如 图 17-11 所 示 。 


文件 四 ÉD SEV 历史 G) RED TAD VIU 
@ c x 2х пата 
Ф MSH $ CAMPHE GDDSRS фин A BAe 


> BARE Firefox ШЕ “yrrny1239126. com” 在 google. con HIBS? BED | Teressa) Bw 


lf you dont receive the massage, fry sending it apain 


Enter your code 
9086051 
Verity 


If youre having trouble verfying your accourt, please герой your issue. 


be ез Bak: 
17-11 输入 验证 码 
(5) 验证 通过 后 ， 在 新 界面 中 继续 输入 信息 ， 如 图 17-12 所 示 。 


THD Wü zio nri БЕШ IAD Ho 
@ „ех x X B [Une aksa cm eir 


Ü © €»muems $omoacms а оная фат нь 三 ана 
Tr [z] Е 
Your developer үнө will determine now you appear to customers In the Алекси Marker 


DevoloporNamo [xui a 


WIE appear Lo sers илбе! the пале of your application 


Email Address угшу 13126 con 
Website URL тее 195. com 
Phone Number [13475958357 


Fclude country собе and area созе why бо we ask fertis? 


Email updates — [7 Contact me occasionally about development and Market opportunities. 


Continue s 


a 
E BI 
17-12 输入 信息 


(6) 单 击 Continue 按钮 后 ， 提 示 需 要 花费 25 美元 ， 支付 后 才能 成 为 正式 会 员 ， 如 图 17-13 所 示 。 


THD RO SEV БӘС EÐ IAD FHD 
QU с x ох B Derman 
Ü ®|Фезлд+шж @ елени DURES фит: o BMS 


[Deme sie E 


Your registration fee ənabləs you to oublsh sofware in the market. The name and bing adrese used to register wil bind you to the Android Markat 
Davelaar Ditrbution Agreerrent Sə mako sure you doublo enockd 

Pay vour registration fee with 

Gorge 


Fast checkout teugh Googie 


[EI FR 
图 17-13 需要 支付 界面 


О And BER RE 


(7) 单 击 cos ШШЕ 按钮 来 到 支付 界面 ， 如 图 17-14 所 示 。 
Android - Devloper Ragietration Fos tor any! 28126 com eo 4 
š Subtotal: $25.00 


Add a credit card to your Google Account to continue 
Shop confidently with Google Checkout 
Sign uo now ang get 100% Protechcn on илал 
shogaing at stores across tne web. 


PT: 2h 
17-14 支付 界面 
在 此 输入 你 的 信用 卡 信息 ， 完 成 支付 后 即 可 成 为 正式 会 员 。 


1732 生成 签名 文件 


Android 程序 的 签名 和 Symbian 类 似 都 可 以 自 签 名 (Selfsigned)， 但 是 在 Android 平台 中 证 书 初 期 
还 显得 形同虚设 ， 平 时 开发 时 通过 ADB 接口 上 传 的 程序 会 自动 被 签 有 Debug 权限 的 程序 。 需 要 签名 
验证 ， 在 上 传 程序 到 Android Market 上 时 大 家 都 已 经 发 现 这 个 问题 了 。 

Android 签名 文件 的 制作 方法 有 以 下 两 种 。 

1. 第 一 种 : 命令 行 生成 

具体 流程 如 下 。 

(1) cmd 命令 如 下 

keytool -genkey -alias android123.keystore -keyalg RSA -validity 20000 -keystore android123.keystore 

然后 一 次 提示 用 户 输入 如 下 信息 : 

输入 keystore 密码 : [密码 不 回 显 ] 

再 次 输入 新 密码 : [密码 不 回 显 ] 

您 的 名 字 与 姓氏 是 什么 ? 

[Unknown]: android123 

您 的 组 织 单 位 名 称 是 什么 ? 

[Unknown]: www.android123.com.cn 

您 的 组 织 名 称 是 什么 ? 

[Unknown]: www.android123.com.cn 

您 的 组 织 名 称 是 什么 ? 

[Unknown]: www.android123.com.cn 

您 所 在 的 城市 或 区 域名 称 是 什么 ? 

[Unknown]: New York 

您 所 在 的 州 或 省 份 名 称 是 什么 ? 

[Unknown]: New York 

该 单位 的 两 字母 国家 代码 是 什么 

[Unknown]: CN 


@ 


第 17 章 移动 阅读 


CN=android123, OU=www.android123.com.cn, O=www.android123.com.cn, L=New York, ST 

=New York, C=CN 正确 吗 ? 

[&]: Y 

输入 <android123.keystore> 的 主 密码 (如 果 和 keystore 密码 相同 ， 按 回 车 ) : 

其 中 参数 -validity 为 证 书 有 效 天 数 ， 这 里 我 们 写 的 大 于 200 天 。 另 外 ,在 输入 密码 时 没有 回 显 ， 直 
接 输入 就 可 以 了 ， 一 般 位 数 建议 使 用 20 位 ， 最 后 需要 记 下 来 后 面 还 要 用 。 接 下 来 就 可 以 为 apk 文件 签 
名 了 。 

(2) 执行 

jarsigner -verbose -keystore android123.keystore -signedjar android123_signed.apk android123.apk 

android123.keystore 


这 样 就 可 以 生成 签名 的 apk 文件 , 假设 输入 文件 android123.apk. 则 最 终生 成 android123 signed.apk 
为 Android 签名 后 的 APK 执行 文件 。 


注意 : keytool 用 法 和 jarsigner 用 法 总 结 


(1) keytool 用 法 

-certreq [-v] [-protected] 
[-alias < 别名 >] [-sigalg <sigalg>] 
[-file <csr_file>] [-keypass < 密 钥 库 口令 >] 
[-keystore < 密 钥 库 >] [-storepass < 存储 库 口 令 >] 
[-storetype < 存储 类 型 >] [-providername < 名 称 >] 
[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] ... 
[-providerpath < 路 径 列 表 >] 


-changealias [-v] [-protected] -alias < 别名 > -destalias < 目标 别名 > 
[-keypass < 密 钥 库 口令 >] 
[-keystore < 密 钥 库 >] [-storepass < 存储 库 口令 >] 
[-storetype < 存储 类 型 >] [-providername < 名 称 >] 
[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] ... 
[-providerpath < 路 径 列 表 >] 


-delete [-v] [-protected] -alias < 别名 > 
[-keystore < 密 钥 库 >] [-storepass < 存储 库 口令 >] 
[-storetype < 存储 类 型 >] [-providername < 名 称 >] 
[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] … 
[-providerpath < 路 径 列 表 >] 


-exportcert [-v] [-гїс] [-protected] 
[-alias < 别名 >] [-file < 认证 文件 >] 
[-keystore < 密 钥 库 >] [-storepass < 存储 库 口 令 >] 
[-storetype < 存储 类 型 >] [-providername < 名 称 >] 


П нен 


[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] … 
[-providerpath < 路 径 列 表 >] 


-genkeypair [-v] [-protected] 
[-alias < 别名 >] 
[-keyalg <keyalg>] [-keysize < 密 钥 大 小 >] 
[-sigalg <sigalg>] [-dname <dname>] 
[-validity <valDays>] [-keypass < 密 钥 库 口 令 >] 
[-keystore < 密 钥 库 >] [-storepass < 存储 库 口令 >] 
[-storetype < 存储 类 型 >] [-providername < 名 称 >] 
[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] … 
[-providerpath < 路 径 列 表 >] 


-genseckey [-v] [-protected] 
[-alias < 别名 >] [-keypass < 密 钥 库 口令 >] 
[-keyalg <keyalg>] [-keysize < 密 钥 大 小 >] 
[-keystore < 密 钥 库 >] [-storepass < 存储 库 口令 >] 
[-storetype < 存储 类 型 >] [-providername < 名 称 >] 
[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] … 
[-providerpath < 路 径 列 表 >] 


-help 

-importcert [-у] [-noprompt] [-trustcacerts] [-protected] 
[alias <344>] 
[-file < 认证 文件 >] [-keypass < 密 钥 库 口令 >] 
[-keystore < 密 钥 库 >] [-storepass < 存储 库 口 令 >] 
[-storetype < 存储 类 型 >] [-providername < 名 称 >] 
[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] … 
[-providerpath < 路 径 列 表 >] 


-importkeystore [-v] 
[-srckeystore < 源 密 钥 库 >] [-destkeystore < 目标 密 钥 库 >] 
[-srestoretype < 源 存储 类 型 >] [-deststoretype < 目标 存储 类 型 >] 
[-srestorepass < 源 存储 库 口令 >] [-deststorepass < 目标 存储 库 口令 >] 
[-sreprotected] [-destprotected] 
[-srcprovidername < 源 提供 方 名 称 >] 
[-destprovidername < 目标 提供 方 名 称 >] 
[-srcalias < 源 别名 > [-destalias < 目标 别名 >] 
[-srckeypass < 源 密 钥 库 口令 >] [-destkeypass < 目标 密 钥 库 口 令 >]] 


e 
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[-порготрї] 
[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] ... 
[-providerpath < 路 径 列 表 >] 


-keypasswd [-v] [-alias < 别名 >] 
[-keypass < 旧 密 钥 库 口令 >] [-new < 新 密 钥 库 口令 >] 
[-keystore < 密 钥 库 >] [-storepass < 存储 库 口令 >] 
[-storetype < 存储 类 型 >] [-providername < 名 称 >] 
[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] … 
[-providerpath < 路 径 列 表 >] 


-list [-v | -rfc] [-protected] 
[-alias < 别名 >] 
[-keystore < 密 钥 库 >] [-storepass < 存储 库 口令 >] 
[-storetype < 存储 类 型 >] [-providername < 名 称 >] 
[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] .… 
[-providerpath < 路 径 列 表 >] 


-printcert [-v] [-file < 认证 文件 >] 


-storepasswd [-v] [-new < 新 存储 库 口 令 >] 
[-keystore < 密 钥 库 >] [-storepass < 存储 库 口令 >] 
[-storetype < 存储 类 型 >] [-providername < 名 称 >] 
[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] ... 
[-providerpath < 路 径 列 表 >] 


(2) jarsigner 用 法 
[选项 ] jar 文件 别名 
jarsigner -verify [选项 ] jar 文件 


[-keystore <url>] 密 钥 库 位 置 

[-storepass < 口令 >] 用 于 密 钥 库 完整 性 的 口令 
[-storetype < 类 型 >] 密 钥 库 类 型 

[-keypass < 口令 >] 专用 密 钥 的 口令 (如 果 不 同 ) 
[-sigfile < 文件 >] .SF/.DSA 文件 的 名 称 
[-signedjar < 文件 >] 已 签名 的 JAR 文件 的 名 称 
[-digestalg < 算法 >] 摘要 算法 的 名 称 

[-sigalg < 算法 >] 签名 算法 的 名 称 

[-verify] 验证 已 签名 的 JAR 文件 
[-verbose] 签名 /验证 时 输出 详细 信息 


[-certs] 输出 详细 信息 和 验证 时 显示 证 书 
[-tsa <url>] ЕН ИЛ И for B: 
[-tsacert < 别名 >] F3 [8] ИЛЫ АЗЕ НАЕ 
[-altsigner < 类 >] 蔡 代 的 签名 机 制 的 类 名 
[-altsignerpath < 路 径 列 表 >] 蔡 代 的 签名 机 制 的 位 置 
[-internalsf] 在 签名 块 内 包含 .SF 文件 
[-sectionsonly] 不 计算 整个 清单 的 散 列 
[-protected] 密 钥 库 已 保护 验证 路 径 
[-providerName < 名 称 >] 提供 者 名 称 

[-providerClass < 类 > 加 密 服务 提供 者 的 名 称 
[-providerArg < 参数 >]] ... 主 类 文件 和 构造 函数 参数 


2. 第 二 种 : Eclipse 的 ADT 生成 
实际 上 ， 使 用 Eclipse 可 以 更 加 直观 、 方 便 地 生成 签名 文件 ， 具 体 流程 如 下 。 
(1) 右键 单 击 Eclipse 项 目 名 ， 在 弹出 快捷 菜单 中 依次 选择 Android Tools | Export Signed Application 
Package 命令 ， 如 图 17-15 所 示 。 


[2010-06-14 14:12: 


图 17-15 选择 导出 
(2) 在 弹出 的 对 话 框 中 选择 要 导出 的 项 目 ， 如 图 17-16 所 示 。 


(3) 单 击 Next 按钮 ， 在 弹出 的 对 话 框 中 选中 Create new keystore 单 选 按钮 ， 然 后 分 别 输入 文件 名 
和 密码 ， 如 图 17-17 所 示 。 


图 17-16 选择 要 导出 的 项 目 17-17 文件 名 和 密码 


(4) 单 击 Next 按钮 ， 在 弹出 的 界面 中 输入 签名 文件 路 径 ， 如 图 17-18 所 示 。 
(5) 单 击 Next 按钮 ， 在 弹出 的 界面 中 依次 输入 签名 文件 的 相关 信息 ， 如 图 17-19 所 示 。 


@_ 
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Destination and key/certificate checks 


a Key Creation 
Destination APE file: ED Brose Mias: fe 
Certificate expires in 30 years, Текин: = 
This will create the following files: Confirm: Te 
123 pk Validity Gems) [ш 


First and Last Bane: [дал M 
Ürgmimtimd Wit [ee s ss SS 
Organization: Im 
City or Locality: [ee 
State or Provine: о 
сану Coe OM): [5 s 


@ «m | o | rmm | оша | Ө — m |ва ] o sss | o cem 
图 17-18 输入 信息 图 17-19 输入 信息 


(6) 单 击 Next 按钮 后 完成 签名 文件 的 创建。 
17.33 ”使 用 签名 文件 


生成 签名 文件 后 ， 就 可 以 使 用 它 了 ， 在 此 也 有 两 种 方式 。 
1. 第 一 种 : 命令 行 

C1) 假设 生成 的 签名 文件 是 ChangeBackgroundWidget.apk， 则 最 终生 成 ChangeBackground- 

Widget_signed.apk 为 Android 签名 后 的 АРК 执行 文件 。 

输入 以 下 命令 行 : 
jarsigner -verbose -keystore ChangeBackgroundWidget.keystore -signedjar ChangeBackgroundWidget signed. 
apk ChangeBackgroundWidget.apk ChangeBackgroundWidget.keystore 

上 面 命令 中 间 不 换行 。 

(2) 按 Enter 键 ， 根 据 提示 输入 密 钥 库 的 口令 短语 〈 即 密码 )， 详 细 信息 如 下 。 
输入 密 钥 库 的 口令 短语 : 
正在 添加 : META-INF/MANIFEST.MF 
正在 添加 : META-INF/CHANGEBA.SF 
正在 添加 : META-INF/CHANGEBA.RSA 
正在 签名 : res/drawable/icon.png 
正在 签名 : res/drawable/icon_audio.png 
正在 签名 : res/drawable/icon_exit.png 
正在 签名 : res/drawable/icon_folder.png 
正在 签名 : res/drawable/icon_home.png 
正在 签名 : res/drawable/icon_img.png 
正在 签名 : res/drawable/icon_left.png 
正在 签名 : res/drawable/icon_mantou.png 
正在 签名 : res/drawable/icon_other.png 
正在 签名 : res/drawable/icon_pause.png 
正在 签名 : res/drawable/icon_play.png 
正在 签名 : res/drawable/icon_retum.png 
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正在 签名 : resldrawable/icon right.png 
正在 签名 : res/drawable/icon_set.png 
正在 签名 : res/drawable/icon_text.png 
正在 签名 : res/drawable/icon_xin.png 
正在 签名 : res/layout/fileitem.xml 
正在 签名 : res/layout/filelist.xml 

正在 签名 : res/layout/main.xml 

正在 签名 : res/layout/widget.xml 
正在 签名 : res/xml/widget_info.xml 
正在 签名 : AndroidManifest.xml 

正在 签名 : resources.arsc 

正在 签名 : classes.dex 


通过 上 述 过 程 处 理 后 , 即 可 将 未 签名 文件 ChangeBackgroundWidget.apk 签名 为 ChangeBackground- 
Widget signed.apk. 

在 上 述 方式 中 ， 读 者 可 能 会 遇 到 以 下 问题 。 

问题 1: jarsigner: 无 法 打开 jar 文件 ChangeBackgroundWidget.apk。 

解决 方法 : 将 要 进行 签名 的 APK 放 到 对 应 的 文件 下 , 把 要 签名 的 ChangeBackgroundWidget.apk Ji 
到 JDK 的 bin 文件 里 。 

问题 2: jarsigner 无 法 对 jar 进行 签名 : java.util.zip.ZipException: invalid entry compressed size (expected 
1598 but got 1622 bytes). 

方法 1: Android 开发 网 提示 这 些 问 题 主要 是 由 于 资源 文件 造成 的 ， 对 于 Android 开发 来 说 应 该 检 
Ж res 文件 夹 中 的 文件 ， 逐 个 排查 。 这 个 问题 可 以 通过 升级 系统 的 JDK 和 IRE 版 本 来 解决 。 

方法 2: 这 是 因为 默认 给 apk 做 了 debug 签名 ， 所 以 无 法 做 新 的 签名 ， 这 时 就 必须 右键 单 击 工程 ， 
选择 Android Tools | Export Unsigned Application Package 命令 。 或 者 从 AndroidManifest.xml 的 Exporting 上 
选择 也 是 一 样 的 。 

然后 再 基于 这 个 导出 的 unsigned apk 做 签名 , 导出 的 时 候 最 好 将 其 目录 选 在 之 前 产生 keystore 的 那 
个 目录 下 ， 这 样 操作 起 来 就 方便 了 。 

2. 第 二 种 : 直接 导入 

第 二 种 方式 是 在 Eclipse 中 直接 导入 的 方式 ， 具体 过 程 和 17.3.2 节 中 第 二 种 方法 的 过 程 类 似 ， 不 再 
WR. 
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发 布 的 过 程 比较 简单 ， 来 到 Market， 登 录 个 人 中 心 ， 上 传 签名 后 的 文件 即 可 ， 具 体操 作 流程 在 
Market 站 点 上 有 详细 说 明 ， 为 节省 篇 幅 ， 在 此 不 做 详细 介绍 。 


第 18 章 UR 本 采集 器 


QR 是 英文 Quick Response 的 缩写 ， 即 快速 反应 。QR 码 比 普通 条 码 可 储存 更 多 资料 ， 扫 描 时 的 要 
求 很 低 , 无须 像 普通 条 码 扫描 时 需 直 线 对 准 扫 描 器 才能 识别 , QR 码 可 以 存储 名 片 信息 等 大 容量 的 内 容 ， 
包括 WIFIACCESS、 文 档 、 数 字 、 网 址 等 ， 因 此 其 应 用 越 来 越 广泛 ， 领 域 包括 电子 商务 、 签 到 、 防 伪 
等 。QR 的 形式 可 以 一 反 往常 的 黑白 色调 以 及 单调 的 方 框 ， 制 作出 很 多 有 趣 生 动 的 QR 二 维 码 。 本 章 将 
通过 一 个 综合 实例 的 实现 过 程 ， 详 细 讲解 在 Android 设备 中 开发 一 个 QR 码 采 集 器 的 方法 。 


GH 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 18 章 \ 信 息 采集 .avi 
本 项 目 实例 的 功能 是 ， 快 速 采集 QR 二 维 码 信息 ， 并 且 可 以 将 自己 的 联系 信息 、 网 站 、 邮 箱 、 推 
特 或 某 个 Android Market 的 应 用 程序 生成 对 应 的 QR 二 维 码 。 


实例 功能 源码 路 径 
实例 18-1 开发 一 个 QR 码 生成 器 光盘 :\codes\18\android-quick-response-code-EX 


信息 采集 的 功能 通过 摄像 头 扫描 拍摄 QR 码 信息 ， 在 本 节 的 内 容 中 ， 将 详细 讲解 信息 采集 模块 的 
具体 实现 流程 。 


18.1.1 采集 界面 的 主 Activity 


本 系统 信息 采集 界面 的 主 Activity 的 实现 文件 是 CaptureActivity.java， 功 能 是 调用 布局 文件 
capture.xml 加 载 显示 UI 控件 ， 通 过 自 定义 的 UI 界面 来 处 理 decodBarcodeFormated 的 内 容 。 文 件 


CaptureActivity java 的 具体 实现 代码 如 下 所 示 。 
public class CaptureActivity extends DecoderActivity { 


private static final String TAG = CaptureActivity.class.getSimpleName(); 
private static final Set<ResultMetadataType> DISPLAYABLE METADATA TYPES = EnumSet.of(Result 
MetadataType.ISSUE_NUMBER, ResultMetadataType.SUGGESTED PRICE, 
ResultMetadataType.ERROR CORRECTION LEVEL, 
ResultMetadataType.POSSIBLE COUNTRY); 


private TextView statusView = null; 
private View resultView = null; 
private boolean inScanMode = false; 


@Override 
public void onCreate(Bundle icicle) { 
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super.onCreate(icicle); 
setContentView(R.layout.capture); 
Log.v(TAG, "onCreate()"); 


resultView = findViewByld(R.id.result view); 
statusView = (TextView) findViewByld(R.id.status view); 


inScanMode - false; 
} 


@Override 

protected void onDestroy() { 
super.onDestroy(); 
Log.v(TAG, "onDestroy()"); 

} 


@Override 

protected void onResume() { 
super.onResume(); 
Log.v(TAG, "onResume()"); 

) 


@Override 

protected void onPause() { 
super.onPause(); 
Log.v(TAG, "onPause()"); 

} 


@Override 
public boolean onKeyDown(int keyCode, KeyEvent event) { 
if (keyCode == KeyEvent.KEYCODE_BACK) { 


if (inScanMode) 
finish(); 
else 
onResume(); 
return true; 
} 
return super.onKeyDown(keyCode, event); 
} 
@Override 


public void handleDecode(Result rawResult, Bitmap barcode) { 
drawResultPoints(barcode, rawResult); 


ResultHandler resultHandler = ResultHandlerFactory.makeResultHandler(this, rawResult); 
handleDecodelnternally(rawResult, resultHandler, barcode); 
} 


protected void showScanner() { 


inScanMode = true; 
@ 


resultView.setVisibility(View.GONE); 
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statusView.setText(R.string.msg_default_status); 
statusView.setVisibility(View. VISIBLE); 
viewfinderView.setVisibility(View.VISIBLE); 


} 

protected void showResults() { 
inScanMode = false; 
statusView.setVisibility(View. GONE); 
viewfinderView.setVisibility(View.GONE); 
resultView.setVisibility(View. VISIBLE); 

} 


II Put up our own UI for how to handle the decodBarcodeFormated contents. 

private void handleDecodelntemally(Result rawResult, ResultHandler resultHandler, Bitmap barcode) { 
onPause(); 
showResults(); 


ImageView barcodelmageView = (ImageView) findViewByld(R.id.barcode_image_view); 
if (barcode == null) { 
barcodelmageView.setlmageBitmap(BitmapFactory.decodeResource(getResources(), 
R.drawable.icon)); 
) else { 
barcodelmageView.setlmageBitmap(barcode); 
) 


TextView formatTextView = (TextView) findViewByld(R.id.format text view); 
formatTextView.setText(rawResult.getBarcodeFormat().toString()); 


TextView typeTextView = (TextView) findViewByld(R.id.type text view); 
typeTextView.setText(resultHandler.getType().toString()); 


DateFormat formatter = DateFormat.getDateTimelnstance(DateFormat.SHORT, DateFormat.SHORT); 
String formattedTime = formatter.format(new Date(rawResult.getTimestamp())); 

TextView timeTextView = (TextView) findViewByld(R.id.time_text_view); 
timeTextView.setText(formattedTime); 


TextView metaTextView = (TextView) findViewByld(R.id.meta text view); 
View metaTextViewLabel = findViewByld(R.id.meta text view label); 
metaTextView.setVisibility (View. GONE); 
metaTextViewLabel.setVisibility(View. GONE); 
Map<ResultMetadataType, Object» metadata = rawResult.getResultMetadata(); 
if (metadata != null) ( 
StringBuilder metadataText = new StringBuilder(20); 
for (Map.Entry<ResultMetadataType, Object» entry : metadata.entrySet()) { 
if (DISPLAYABLE METADATA TYPES.contains(entry.getKey())) ( 
metadataText.append(entry.getValue()).append(^n"); 
H 
} 
if (metadataText.length() > 0) { 
metadataText.setLength(metadataText.length() - 1); 
metaTextView.setText(metadataT ext); 
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metaTextView.setVisibility(View. VISIBLE); 
metaTextViewLabel.setVisibility( View. VISIBLE); 


} 


TextView contentsTextView = (TextView) findViewByld(R.id.contents_text_view); 
CharSequence displayContents = resultHandler.getDisplayContents(); 
contentsTextView.setText(displayContents); 
11 Crudely scale betweeen 22 and 32 -- bigger font for shorter text 
int scaledSize = Math.max(22, 32 - displayContents.length() / 4); 
contentsTextView.setTextSize(TypedValue.COMPLEX UNIT SP, scaledSize); 
) 
} 
布局 文件 capture.xml 的 具体 实现 代码 如 下 所 示 。 
<FrameLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:layout_width="fill_ parent" 
android:layout_height="fill_parent"> 
«SurfaceView android:id="@tid/preview_view" 
android:layout_width="fill_ parent" 
android:layout_height="fill_ parent"> 
</SurfaceView> 
<com.jwetherell.quick response code.ViewfinderView 
android:id-" (9 *id/viewfinder view" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:background="@color/transparent"> 
</com.jwetherell.quick_response_code.ViewfinderView> 
«LinearLayout android:id="@+id/result_view" 
android:orientation="horizontal" 
android:layout width-"fill parent" 
android:layout heightz"fill parent" 
android:background="@color/result_view" 
android:gravity="center" 
android:padding="4dip"> 


<LinearLayout 
android:orientation="vertical" 
android:layout_width="wrap_content" 
android:layout_height="fill_ parent" 
android:gravity="right|center_vertical"> 


«ImageView android:id-"(g)*id/barcode image view" 
android:layout_width="160dip" 
android:layout height-"wrap content" 
android:maxWidth-"160dip" 
android:maxHeight="160dip" 
android:layout_marginBottom="4dip" 
android:adjustViewBounds="true" 
android:scaleType-"centerlnside" 
android:contentDescription-"(g)string/barcode image" 
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</ImageView> 


<LinearLayout 

android:orientation="horizontal" 

android:layout_width="wrap_content" 

android:layout_height="wrap_content"> 

<TextView android:id="@+id/format_text_view_label" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"(Qstring/msg default format" 
android:textColor-"(Qcolor/result minor text" 
android:textStyle="bold" 
android:textSize="14sp" 
android:paddingRight="4dip"> 

</TextView> 

<TextView android:id="@+id/format_text_view" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:textColor="@color/result_minor_ text" 
android:textSize="14sp"> 

</TextView> 

</LinearLayout> 


<LinearLayout 

android:orientation="horizontal" 

android:layout_width="wrap_content" 

android:layout height-"wrap content"» 

<TextView android:id-"(Q)*id/type text view label" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="@string/msg_default_type" 
android:textColor="@color/result_minor_text" 
android:textStyle="bold" 
android:textSize="14sp" 


android:paddingRight="4dip"> 
</TextView> 
<TextView android:id-"(g)*id/type text view" 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:textColor-"(g.color/result minor text" 
android:textSize="14sp"> 
</TextView> 
</LinearLayout> 


<LinearLayout 
android:orientation="horizontal" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content"> 
<TextView android:id="@+id/time_text_view_label" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
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android:text="@string/msg_default_time" 
android:textColor="@color/result_minor_text" 
android:textStyle="bold" 
android:textSize="14sp" 
android:paddingRight="4dip"> 

</TextView> 

<TextView android:id="@+id/time_text_view" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:textColor-"(g)color/result minor text" 
android:textSize="14sp"> 

</TextView> 

</LinearLayout> 


<LinearLayout 

android:orientation="horizontal" 

android:layout_width="wrap_content" 

android:layout_height="wrap_content"> 

«TextView android:id="@tid/meta_text_view_label" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="@string/msg_default_meta" 
android:textColor="@color/result_minor_text" 
android:textStyle="bold" 
android:textSize="14sp" 


android:paddingRight="4dip"> 
</TextView> 
<TextView android:id="@+id/meta_text_view" 


android:layout_width="wrap_content" 
android:layout height="wrap content" 
android:textColor="@color/result_minor_text" 
android:textSize="14sp"> 
</TextView> 
</LinearLayout> 


</LinearLayout> 


<ScrollView 


android:layout width="wrap content" 
android:layout_height="wrap_content"> 
<LinearLayout 

android:layout_width="wrap_content" 

android:layout_height="wrap_content" 

android:orientation="vertical"> 

<TextView android:id="@+id/contents_text_view" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:textColor="@color/result_text" 
android:textColorLink="@color/result_text" 
android:textSize="22sp" 
android:paddingLeft="12dip"> 
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</TextView> 
</LinearLayout> 
</ScrollView> 


</LinearLayout> 


«TextView android:id="@+id/status_view" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout gravity-"bottom|center horizontal" 
android:background="@color/transparent" 
android:text="@string/msg_default_status" 
android:textColor="@color/status_text" 
android:textSize="14sp"> 

</TextView> 

</FrameLayout> 


18.1.2 ”相机 采集 


在 采集 外 部 信息 时 ， 是 通过 设备 中 自 带 的 摄像 头 拍照 实现 的 。 其 中 文件 
现 自动 对 焦 回 调处 理 ， 具 体 实现 代码 如 下 所 示 。 
final class AutoFocusCallback implements Camera.AutoFocusCallback { 
private static final String TAG = AutoFocusCallback.class.getSimpleName(); 
private static final long AUTOFOCUS_INTERVAL_MS = 1500L; 
private Handler autoFocusHandler; 
private int autoFocusMessage; 
void setHandler(Handler autoFocusHandler, int autoFocusMessage) ( 
this.autoFocusHandler = autoFocusHandler; 
this.autoFocusMessage = autoFocusMessage; 
} 
@Override 
public void onAutoFocus(boolean success, Camera camera) { 
if (autoFocusHandler != null) { 


AutoFocusCallback.java Ж 


Message message = autoFocusHandler.obtainMessage(autoFocusMessage, success); 


II Simulate continuous autofocus by sending a focus request every 
II AUTOFOCUS INTERVAL MS milliseconds 
II Log.d(TAG, "Got auto-focus callback; requesting another"); 


autoFocusHandler.sendMessageDelayed(message, AUTOFOCUS INTERVAL MS); 


autoFocusHandler - null; 
}else { 
Log.d(TAG, "Got auto-focus callback, but no handler for it"); 
} 
} 
} 
文件 CameraConfigurationManager.java 实现 了 相机 配置 管理 器 功能 ， 其 二 


涉及 了 阅读 采集 、 拍 照 分 


析 和 设置 相机 参数 功能 。 文 件 CameraConfigurationManagerjava 的 具体 实现 代码 如 下 所 示 。 


public final class CameraConfigurationManager { 


private static final String TAG = "CameraConfiguration"; 


2» 
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private static final int MIN_PREVIEW_PIXELS = 320 * 240; // small screen 
private static final int MAX_PREVIEW_PIXELS = 800 * 480; // large/HD screen 


private final Context context; 
private Point screenResolution; 
private Point cameraResolution; 


public CameraConfigurationManager(Context context) { 
this.context = context; 


} 


p 
“BRERA SANE 
di 
void initFromCameraParameters(Camera camera) { 
Camera.Parameters parameters = camera.getParameters(); 
WindowManager manager = (WindowManager) context.getSystemService(Context. WINDOW SERVICE); 
Display display = manager.getDefaultDisplay(); 
int width = display.getWidth(); 
int height = display.getHeight(); 


if (width « height) ( 
Log.i(TAG, "Display reports portrait orientation; assuming this is incorrect"); 
int temp = width; 
width = height; 
height = temp; 
} 


screenResolution = new Point(width, height); 

Log.i(TAG, "Screen resolution: " + screenResolution); 

cameraResolution = findBestPreviewSizeValue(parameters, screenResolution, false); 
Log.i(TAG, "Camera resolution: " + cameraResolution); 


} 


void setDesiredCameraParameters(Camera camera) { 
Camera.Parameters parameters = camera.getParameters(); 


if (parameters == null) { 
Log.w(TAG, "Device error: no camera parameters are available. Proceeding without configuration."); 
return; 


} 


initializeTorch(parameters); 
String focusMode = findSettableValue(parameters.getSupportedFocusModes(), Camera.Parameters. 


FOCUS MODE AUTO, Camera.Parameters.FOCUS MODE. MACRO); 


if (focusMode !- null) ( 
parameters.setFocusMode(focusMode); 


} 


parameters.setPreviewSize(cameraResolution.x, cameraResolution.y); 
camera.setParameters(parameters); 
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public Point getCameraResolution() ( 
return cameraResolution; 


} 


public Point getScreenResolution() { 
return screenResolution; 


} 


void setTorch(Camera camera, boolean newSetting) { 
Camera.Parameters parameters = camera.getParameters(); 
doSetTorch(parameters, newSetting); 
camera.setParameters(parameters); 


} 


private static void initialize Torch(Camera.Parameters parameters) { 
doSetTorch(parameters, Preferences.KEY FRONT LIGHT); 


} 

private static void doSetTorch(Camera.Parameters parameters, boolean newSetting) { 
String flashMode; 
if (newSetting) ( 


flashMode - findSettableValue(parameters.getSupportedFlashModes(), Camera.Parameters. 
FLASH MODE TORCH, Camera.Parameters.FLASH MODE ON); 
) else { 
flashMode = findSettableValue(parameters.getSupportedFlashModes(), Camera.Parameters. 
FLASH_MODE_OFF); 
} 
if (flashMode != null) { 
parameters.setFlashMode(flashMode); 
} 
} 


private static Point findBestPreviewSizeValue(Camera.Parameters parameters, Point screenResolution, 
boolean portrait) { 

Point bestSize = null; 

int diff = Integer.MAX VALUE; 

for (Camera.Size supportedPreviewSize : parameters.getSupportedPreviewSizes()) { 
int pixels = supportedPreviewSize.height * supportedPreviewSize.width; 
if (pixels < MIN PREVIEW PIXELS || pixels > MAX PREVIEW PIXELS) { 

continue; 

} 
int supportedWidth = portrait ? supportedPreviewSize.height : supportedPreviewSize.width; 
int supportedHeight = portrait ? supportedPreviewSize.width : supportedPreviewSize.height; 
int newDiff = Math.abs(screenResolution.x * supportedHeight - supportedWidth * screenResolution.y); 


if (newDiff == 0) { 
bestSize = new Point(supportedWidth, supportedHeight); 
break; 

} 

if (newDiff < diff) { 
bestSize = new Point(supportedWidth, supportedHeight); 
diff = newDiff; 
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} 
} 
if (bestSize == null) { 
Camera.Size defaultSize = parameters.getPreviewSize(); 
bestSize = new Point(defaultSize.width, defaultSize. height); 
} 
return bestSize; 


} 


private static String findSettableValue(Collection<String> supportedValues, String... desiredValues) { 
Log.i(TAG, "Supported values: " + supportedValues); 
String result = null; 
if (supportedValues != null) { 
for (String desiredValue : desiredValues) { 
if (supportedValues.contains(desiredValue)) { 
result = desiredValue; 
break; 


} 


} 
Log.i(TAG, "Settable value: " + result); 
return result; 


} 
18.1.3 ”实现 取景 器 功能 


文件 PreviewCallback.java 的 功能 是 实现 当前 相机 拍照 的 预览 功能 ， 有 具体 实现 代码 如 下 所 示 。 
final class PreviewCallback implements Camera.PreviewCallback { 
private static final String TAG = PreviewCallback.class.getSimpleName(); 


private final CameraConfigurationManager configManager; 
private Handler previewHandler; 
private int previewMessage; 
PreviewCallback(CameraConfigurationManager configManager) { 
this.configManager = configManager; 
} 
void setHandler(Handler previewHandler, int previewMessage) { 
this.previewHandler = previewHandler; 
this.previewMessage = previewMessage; 
} 
@Override 
public void onPreviewFrame(byte[ ] data, Camera camera) { 
Point cameraResolution = configManager.getCameraResolution(); 
Handler thePreviewHandler = previewHandler; 
if (thePreviewHandler != null) { 
Message message = thePreviewHandler.obtainMessage(previewMessage, cameraResolution.x, 
cameraResolution.y, data); 
message.sendToTarget(); 
previewHandler = null; 
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) else ( 
Log.d(TAG, "Got preview callback, but no handler for it"); 
) 
) 
) 
编写 文件 ViewfinderView.java 生成 一 个 取景 器 视图 ， 此 视图 被 覆盖 在 相机 预览 界面 的 顶部， 这 样 增加 
了 取景 器 的 矩形 和 外 面部 分 的 透明 性 ， 以 及 激光 扫描 器 动画 和 结果 值 的 清晰 度 。 文 件 ViewfinderView.java 
的 具体 实现 代码 如 下 所 示 。 


public final class ViewfinderView extends View { 


private static final int[ ] SCANNER_ALPHA = { 0, 64, 128, 192, 255, 192, 128, 64 }; 
private static final long ANIMATION_DELAY = 80L; 

private static final int CURRENT_POINT_OPACITY = 0xA0; 

private static final int MAX RESULT POINTS = 20; 

private static final int POINT SIZE = 6; 


private CameraManager cameraManager; 
private final Paint paint; 

private Bitmap resultBitmap; 

private final int maskColor; 

private final int resultColor; 

private final int frameColor; 

private final int laserColor; 

private final int resultPointColor; 

private int scannerAlpha; 

private List<ResultPoint> possibleResultPoints; 
private List<ResultPoint> lastPossibleResultPoints; 


/ This constructor is used when the class is built from an XML resource. 
public ViewfinderView(Context context, AttributeSet attrs) { 
super(context, attrs); 


II Initialize these once for performance rather than calling them every 
11 time іп onDraw(). 

paint = new Paint(Paint.ANTI ALIAS FLAG); 

Resources resources = getResources(); 

maskColor = resources.getColor(R.color.viewfinder_mask); 
resultColor = resources.getColor(R.color.result_view); 

frameColor = resources.getColor(R.color.viewfinder_frame); 
laserColor = resources.getColor(R.color.viewfinder_laser); 
resultPointColor = resources.getColor(R.color.possible_result_points); 
scannerAlpha = 0; 

possibleResultPoints = new ArrayList<ResultPoint>(5); 
lastPossibleResultPoints = null; 


} 


public void setCameraManager(CameraManager cameraManager) { 
this.cameraManager = cameraManager; 


} 
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@Override 
public void onDraw(Canvas canvas) í 


Rect frame = cameraManager.getFramingRect(); 
if (frame == null) ( 
return; 
) 
int width = canvas.getWidth(); 
int height = canvas.getHeight(); 


11 Draw the exterior (i.e. outside the framing rect) darkened 
paint.setColor(resultBitmap != null ? resultColor : maskColor); 
canvas.drawRect(0, 0, width, frame.top, paint); 

canvas.drawRect(0, frame.top, frame.left, frame.bottom + 1, paint); 
canvas.drawRect(frame.right + 1, frame.top, width, frame.bottom + 1, paint); 
canvas.drawRect(0, frame.bottom + 1, width, height, paint); 


if (resultBitmap != null) { 
// Draw the opaque result bitmap over the scanning rectangle 
paint.setAlpha(CURRENT_ POINT OPACITY); 
canvas.drawBitmap(resultBitmap, null, frame, paint); 

) else { 


11 Draw a two pixel solid black border inside the framing rect 
paint.setColor(frameColor); 

canvas.drawRect(frame.left, frame.top, frame.right + 1, frame.top + 2, paint); 
canvas.drawRect(frame.left, frame.top + 2, frame.left + 2, frame.bottom - 1, paint); 
canvas.drawRect(frame.right - 1, frame.top, frame.right + 1, frame.bottom - 1, paint); 
canvas.drawRect(frame.left, frame.bottom - 1, frame.right + 1, frame.bottom + 1, paint); 


11 Draw а red "laser scanner" line through the middle to show 

II decoding is active 

paint.setColor(laserColor); 
paint.setAlpha(SCANNER_ALPHA{scannerAlpha]); 

scannerAlpha = (scannerAlpha + 1) % SCANNER_ALPHA.length; 

int middle = frame.height() / 2 + frame.top; 

canvas.drawRect(frame.left + 2, middle - 1, frame.right - 1, middle + 2, paint); 


Rect previewFrame = cameraManager.getFramingRectlnPreview(); 
float scaleX = frame.width() / (float) previewFrame.width(); 
float scaleY = frame.height() / (float) previewFrame.height(); 


List<ResultPoint> currentPossible = possibleResultPoints; 
List<ResultPoint> currentLast = lastPossibleResultPoints; 
int frameLeft = frame.left; 
int frameTop = frame.top; 
if (currentPossible.isEmpty()) { 
lastPossibleResultPoints = null; 
) else ( 
possibleResultPoints = new ArrayList<ResultPoint>(5); 
lastPossibleResultPoints = currentPossible; 
paint.setAlpha(CURRENT_POINT_OPACITY); 
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paint.setColor(resultPointColor); 
synchronized (currentPossible) { 
for (ResultPoint point : currentPossible) { 
canvas.drawCircle(frameLeft + (int) (point.getX() * scaleX), frameTop + (int) 
(point.getY() * scaleY), POINT SIZE, paint); 
) 
) 
} 
if (currentLast != null) { 
paint.setAlpha(CURRENT_POINT_OPACITY / 2); 
paint.setColor(resultPointColor); 
synchronized (currentLast) { 
for (ResultPoint point : currentLast) { 
canvas.drawCircle(frameLeft + (int) (point.getX() * scaleX), frameTop + (int) 
(point.getY() * scaleY), POINT SIZE / 2, paint); 
} 
} 
} 


// Request another update at the animation interval, but only 
// repaint the laser line, 
II not the entire viewfinder mask 
postinvalidateDelayed(ANIMATION DELAY, frame.left - POINT SIZE, frame.top - POINT SIZE, 
frame.right + POINT SIZE, frame.bottom + POINT SIZE); 
} 
} 


public void drawViewfinder() { 
Bitmap resultBitmap = this.resultBitmap; 
this.resultBitmap = null; 
if (resultBitmap != null) { 
resultBitmap.recycle(); 
} 
invalidate(); 
} 


p 
“绘制 位 图 与 突出 显示 的 视图 ， 而 不 是 实时 扫描 显示 


* @рагат barcode 
ы An image of the decoded barcode. 
8 
public void drawResultBitmap(Bitmap barcode) ( 
resultBitmap = barcode; 
invalidate(); 
} 


public void addPossibleResultPoint(ResultPoint point) { 
List<ResultPoint> points = possibleResultPoints; 
synchronized (point) { 
points.add(point); 
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int size = points.size(); 
if (size > MAX_RESULT POINTS) { 
II trim it 
points.subList(0, size - MAX_RESULT_POINTS / 2).clear(); 


18.2 解码 处 理 


知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 18 章 \ 解 码 处 理 .avi 
当 拍照 采集 到 QR 二 维 码 信息 后 ， 需 要 通过 解码 机 制 来 获取 在 这 个 二 维 码 中 包含 的 具体 信息 。 在 
本 节 的 内 容 中 ， 将 详细 讲解 解码 功能 的 具体 实现 流程 。 


18.2.1 实现 解码 处 理 功能 


编写 文件 DecoderActivityjava， 功 能 是 调用 并 加 载 解码 UI 布局 文件 中 的 控件 ， 有 具体 实现 代码 如 下 
所 示 。 
public class DecoderActivity extends Activity implements IDecoderActivity, SurfaceHolder.Callback { 
private static final String TAG = DecoderActivity.class.getSimpleName(); 
protected DecoderActivityHandler handler = null; 
protected ViewfinderView viewfinderView = null; 
protected CameraManager cameraManager = null; 
protected boolean hasSurface = false; 
protected Collection<BarcodeFormat> decodeFormats = null; 
protected String characterSet = null; 
@Override 
public void onCreate(Bundle icicle) { 
super.onCreate(icicle); 
setContentView(R.layout.decoder); 
Log.v(TAG, "onCreate()"); 
Window window = getWindow(); 
window.addFlags(WindowManager.LayoutParams.FLAG KEEP SCREEN ON); 
handler = null; 
hasSurface - false; 
) 


@Override 

protected void onDestroy() { 
super.onDestroy(); 
Log.v(TAG, "onDestroy()"); 

} 


@Override 
protected void onResume() { 
super.onResume(); 


@ 
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Log.v(TAG, "onResume()"); 


11 这 里 的 CameraManager 必须 初始 化 ， 而 不 是 在 onCreate() 中 进行 


if (cameraManager == null) cameraManager = new CameraManager(getApplication()); 


if (viewfinderView == null) { 
viewfinderView = (ViewfinderView) findViewByld(R.id.viewfinder_view); 
viewfinderView.setCameraManager(cameraManager); 


} 
showScanner(); 


SurfaceView surfaceView = (SurfaceView) findViewByld(R.id.preview_view); 
SurfaceHolder surfaceHolder = surfaceView.getHolder(); 
if (hasSurface) { 
II The activity was paused but not stopped, so the surface still 
11 exists. Therefore 
ll surfaceCreated() won't be called, so init the camera here 
initCamera(surfaceHolder); 
) else { 
// Install the callback and wait for surfaceCreated() to init the 
ll camera 
surfaceHolder.addCallback(this); 
surfaceHolder.setType(SurfaceHolder.SURFACE TYPE PUSH BUFFERS); 


} 


@Override 

protected void onPause() { 
super.onPause(); 
Log.v(TAG, "onPause()"); 


if (handler != null) { 
handler.quitSynchronously(); 
handler = null; 


К 
cameraManager.closeDriver(); 


if (IhnasSurface) ( 
SurfaceView surfaceView = (SurfaceView) findViewByld(R.id.preview view); 
SurfaceHolder surfaceHolder = surfaceView.getHolder(); 
surfaceHolder.removeCallback(this); 


} 


@Override 
public boolean onKeyDown(int keyCode, KeyEvent event) { 
if (keyCode == KeyEvent.KEYCODE_FOCUS || keyCode == KeyEvent.KEYCODE_CAMERA) { 
// 处 理 这 些 事件 ， 使 它们 不 启动 相机 应 用 程序 
K 


return true; 


E: 
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@ 


} 
return super.onKeyDown(keyCode, event); 


} 


@Override 
public void surfaceCreated(SurfaceHolder holder) { 
if (holder == null) 
Log.e(TAG, "*** WARNING *** surfaceCreated() gave us a null surface!"); 


if (!hasSurface) { 
hasSurface = true; 
initCamera(holder); 
} 
} 
@Override 


public void surfaceDestroyed(SurfaceHolder holder) { 
hasSurface = false; 


} 


@Override 
public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) { 
II lgnore 


} 


@Override 
public ViewfinderView getViewfinder() { 
return viewfinderView; 


} 


@Override 
public Handler getHandler() { 
return handler; 


) 


@Override 
public CameraManager getCameraManager() { 
return cameraManager; 


} 


@Override 

public void handleDecode(Result rawResult, Bitmap barcode) { 
drawResultPoints (barcode, rawResult); 

} 


protected void drawResultPoints(Bitmap barcode, Result rawResult) { 
ResultPoint[ ] points = rawResult.getResultPoints(); 
if (points != null && points.length > 0) ( 
Canvas canvas = new Canvas(barcode); 
Paint paint = new Paint(); 
paint.setColor(getResources().getColor(R.color.result image border)); 
paint.setStrokeWidth(3.0f); 
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paint.setStyle(Paint.Style.STROKE); 
Rect border = new Rect(2, 2, barcode.getWidth() - 2, barcode.getHeight() - 2); 
canvas.drawRect(border, paint); 


paint.setColor(getResources().getColor(R.color.result_points)); 
if (points.length == 2) { 
paint.setStrokeWidth(4.0f); 
drawLine(canvas, paint, points[0], points[1]); 
) else if (points.length == 4 && (rawResult.getBarcodeFormat() == BarcodeFormat.UPC A || 
rawResult.getBarcodeFormat() == BarcodeFormat.EAN 13)) ( 
// 画 出 两 条 线 ， 用 于 表示 条 形 码 和 元 数据 
drawLine(canvas, paint, points[0], points[1]); 
drawLine(canvas, paint, points[2], points[3]); 
) else { 
paint.setStrokeWidth(10.0f); 
for (ResultPoint point : points) ( 
canvas.drawPoint(point.getX(), point.getY(), paint); 
) 


) 


protected static void drawLine(Canvas canvas, Paint paint, ResultPoint a, ResultPoint b) ( 
canvas.drawLine(a.getX(), a.getY(), b.getX(), b.getY(), paint); 
} 


protected void showScanner() { 
viewfinderView.setVisibility(View.VISIBLE); 


} 


protected void initCamera(SurfaceHolder surfaceHolder) { 

try ( 
cameraManager.openDriver(surfaceHolder); 
// 创 建 处 理 程序 开始 预览 ， 这 也 可 以 抛 出 一 个 RuntimeException 异常 
if (handler == null) handler = new DecoderActivityHandler(this, decodeFormats, characterSet, 

cameraManager); 

} catch (IOException ioe) { 
Log.w(TAG, ioe); 

} catch (RuntimeException e) { 
11 Barcode Scanner has seen crashes in the wild of this variety: 
II java.?lang.?RuntimeException: Fail to connect to camera service 
Log.w(TAG, "Unexpected error initializing camera", e); 


) 
) 
布局 文件 decoder. xml 的 具体 实现 代码 如 下 所 示 。 
<FrameLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent"> 
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<SurfaceView android:id="@+id/preview_view" 
android:layout_width="fill_ parent" 
android:layout_height="fill_parent"> 
</SurfaceView> 


«com.jwetherell.quick response code.ViewfinderView 
android:id-"(g)*id/viewfinder view" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:background="@color/transparent"> 
</com.jwetherell.quick response code. ViewfinderView> 


<TextView android:id="@+id/status_view" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:layout gravity-"bottom|center horizontal" 
android:background="@color/transparent" 
android:text="@string/msg_default_status" 
android:textColor="@color/status_text" 
android:textSize="14sp"/> 


</FrameLayout> 


18.2.2 ”解码 矩形 框 中 的 数据 


编写 文件 DecodeHandlerjava， 功 能 是 获取 取景 器 矩形 框 中 的 数据 ， 并 对 和 矩形 框 区 域 中 的 数据 进行 
解码 处 理 。 文 件 DecodeHandlerjava 的 具体 实现 代码 如 下 所 示 。 
final class DecodeHandler extends Handler { 

private static final String TAG = DecodeHandler.class.getSimpleName(); 

private final IDecoderActivity activity; 

private final MultiFormatReader multiFormatReader; 

private boolean running = true; 

DecodeHandler(IDecoderActivity activity, Map«DecodeHintType, Object» hints) { 
multiFormatReader = new MultiFormatReader(); 
multiFormatReader.setHints(hints); 
this.activity = activity; 


} 
@Override 
public void handleMessage(Message message) { 
if (Irunning) { 
return; 
} 
switch (message.what) { 
case R.id.decode: 
decode((byte[ ]) message.obj, message.arg1, message.arg2); 
break; 
case R.id.quit: 
running = false; 
Looper.myLooper().quit(); 
break; 
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} 
} 
private void decode(byte[ ] data, int width, int height) { 
long start = System.currentTimeMillis(); 
Result rawResult = null; 
PlanarYUVLuminanceSource source = activity.getCameraManager().buildLuminanceSource(data, 
width, height); 
if (source != null) { 
BinaryBitmap bitmap = new BinaryBitmap(new HybridBinarizer(source)); 
try { 
rawResult = multiFormatReader.decodeWithState(bitmap); 
} catch (ReaderException re) { 
11 continue 
} finally { 
multiFormatReader.reset(); 
} 
} 


Handler handler = activity.getHandler(); 
if (rawResult != null) { 
II Don't log the barcode contents for security 
long end = System.currentTimeMillis(); 
Log.d(TAG, "Found barcode in " + (end - start) + " ms"); 
if (handler != null) { 
Message message = Message.obtain(handler, R.id.decode succeeded, rawResult); 
Bundle bundle = new Bundle(); 
bundle.putParcelable(DecodeThread.BARCODE BITMAP, source.renderCroppedGreyscale- 


Bitmap()); 
message.setData(bundle); 
message.sendToTarget(); 
} 
) else { 
if (handler != null) ( 
Message message = Message.obtain(handler, R.id.decode_failed); 
message.sendToTarget(); 
) 
) 
} 
} 


1823 处理 全 部 状态 的 采集 信息 


文件 DecoderActivityHandlerjava 的 功能 是 处 理 全 部 状态 的 采集 信息 ， 通 过 自动 对 焦 技术 迅速 采集 
指定 区 域 的 QR 信息 。 文 件 DecoderActivityHandlerjava 的 具体 实现 代码 如 下 所 示 。 
public final class DecoderActivityHandler extends Handler { 
private static final String ТАС = DecoderActivityHandler.class.getSimpleName(); 
private final IDecoderActivity activity; 
private final DecodeThread decodeThread; 
private final CameraManager cameraManager; 
private State state; 
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private enum State { 
PREVIEW, SUCCESS, DONE 
} 
DecoderActivityHandler(IDecoderActivity activity, Collection<BarcodeFormat> decodeFormats, String 
characterSet, 
CameraManager cameraManager) { 
this.activity = activity; 
decodeThread = new DecodeThread(activity, decodeFormats, characterSet, new ViewfinderResult 
PointCallback( 
activity.getViewfinder())); 
decodeThread.start(); 
state = State. SUCCESS; 


II Start ourselves capturing previews and decoding 
this.cameraManager = cameraManager; 
cameraManager.startPreview(); 
restartPreviewAndDecode(); 


} 


@Override 
public void handleMessage(Message message) { 
switch (message.what) { 
case R.id.auto_focus: 
11 Log.d(TAG, "Got auto-focus message"); 
// 实 现 自动 对 焦 ， 原 理 是 当 一 个 自动 对 焦 完成 时 马上 开始 另 一 个 
if (state == State.PREVIEW) cameraManager.requestAutoFocus(this, R.id.auto_focus); 
break; 
case R.id.restart_preview: 
Log.d(TAG, "Got restart preview message"); 
restartPreviewAndDecode(); 
break; 
case R.id.decode_succeeded: 
Log.d(TAG, "Got decode succeeded message"); 
state = State. SUCCESS; 
Bundle bundle = message.getData(); 
Bitmap barcode = bundle == null ? null : (Bitmap) bundle.getParcelable(Decode Thread. 
BARCODE BITMAP); 
activity.handleDecode((Result) message.obj, barcode); 
break; 
case R.id.decode failed: 
/快速 解码 ， 当 一 个 解码 失败 后 启动 另 一 个 
state = State. PREVIEW; 
cameraManager.requestPreviewFrame(decode Thread.getHandler(), R.id.decode); 
break; 
case R.id.return scan result: 
Log.d(TAG, "Got return scan result message"); 
if (activity instanceof Activity) { 
((Activity) activity).setResult(Activity. RESULT OK, (Intent) message.obj); 
((Activity) activity).finish(); 
}else{ 
Log.e(TAG, "Scan result message, activity is not Activity. Doing nothing."); 


6. 


вве gagas 000 


break; 


public void quitSynchronously() ( 
state = State.DONE; 
cameraManager.stopPreview(); 
Message quit = Message. obtain(decodeThread.getHandler(), R.id.quit); 
quit.sendToTarget(); 
try { 
/| 最 多 等 待 半 秒 钟 ， 在 onPause() 时 将 很 快 超时 
decodeThread join(500L); 
} catch (InterruptedException e) { 
ll continue 


} 
// 绝 对 确保 不 会 发 送 任何 排队 的 消息 


removeMessages(R.id.decode succeeded); 
removeMessages(R.id.decode failed); 


) 
void restartPreviewAndDecode() ( 
if (state == State.SUCCESS) ( 
state = State.PREVIEW; 
cameraManager.requestPreviewFrame(decodeThread.getHandler(), R.id.decode); 
cameraManager.requestAutoFocus(this, R.id.auto focus); 
activity.getViewfinder().drawViewfinder(); 
) 
) 


} 
1824 ”多 线程 处 理 

为 了 提高 解码 效率 ， 编 写 文件 DecodeThreadjava， 功 能 是 快速 执行 图 像 解码 工作 ， 具 体 实现 代码 
如 下 所 示 。 


final class DecodeThread extends Thread { 


private static final String TAG = DecodeThread.class.getSimpleName(); 
public static final String BARCODE_BITMAP = "barcode bitmap"; 


private final IDecoderActivity activity; 
private final Map<DecodeHintType, Object> hints; 
private final CountDownLatch handlerlnitLatch; 


private Handler handler; 


DecodeThread(IDecoderActivity activity, Collection<BarcodeFormat> decodeFormats, String characterSet, 


ResultPointCallback resultPointCallback) { 
9 
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} 


this.activity = activity; 
handlerlnitLatch = new CountDownLatch(1); 
hints = new EnumMap<DecodeHintType, Object>(DecodeHintType.class); 


11 The prefs can't change while the thread is running, so pick them up 
II once here 
if (decodeFormats == null || decodeFormats.isEmpty()) { 
if (activity instanceof Activity) ( 
decodeFormats = EnumSet.noneOf(BarcodeFormat.class); 
if (Preferences.KEY DECODE 1D)( 
decodeFormats.addAll(DecodeFormatManager.ONE D FORMATS); 
) 
if (Preferences.KEY DECODE QR){ 
decodeFormats.addAIl(DecodeFormatManager.QR CODE FORMATS); 
} 
if (Preferences.KEY DECODE DATA MATRIX) { 
decodeFormats.addAll(DecodeFormatManager.DATA_MATRIX_FORMATS); 
} 
) else { 
Log.e(TAG, "activity is not an Activity, not handling preferences."); 
} 
} 
hints.put(DecodeHintType.POSSIBLE_FORMATS, decodeFormats); 
if (characterSet != null) { 
hints.put(DecodeHintType.CHARACTER_SET, characterSet); 
} 
hints.put(DecodeHintType.NEED RESULT POINT CALLBACK, resultPointCallback); 


Handler getHandler() { 


} 


try ( 
handlerlnitLatch.await(); 

} catch (InterruptedException ie) { 
/ continue? 

) 


return handler; 


@Override 
public void run() { 


Looper.prepare(); 

handler = new DecodeHandler(activity, hints); 
handlerlnitLatch.countDown(); 

Looper.loop(); 
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18.2.5 读 取 QR 码 


编写 文件 QRCodeReaderjava 读 取 QR 二 维 码 的 信息 , 通过 此 文件 可 以 检测 并 读 取 图 像 中 的 QR 二 
维 码 信息 。 文 件 QRCodeReaderjava 的 具体 实现 代码 如 下 所 示 。 
public class QRCodeReader implements Reader { 
private static final ResultPoint[ ] NO POINTS = new ResultPoint[0]; 
private final Decoder decoder = new Decoder(); 
protected Decoder getDecoder() { 
return decoder; 


p 
* 定 位 和 图 像 解码 的 QR 码 
off 
@Override 
public Result decode(BinaryBitmap image) throws NotFoundException, ChecksumException, 
FormatException { 
return decode(image, null); 
} 
@Override 
public Result decode(BinaryBitmap image, Map<DecodeHintType, ?> hints) throws NotFoundException, 
ChecksumException, FormatException ( 
DecoderResult decoderResult; 
ResultPoint[ ] points; 
if (hints != null && hints.containsKey(DecodeHintType.PURE BARCODE)) { 
BitMatrix bits = extractPureBits(image.getBlackMatrix()); 
decoderResult = decoder.decode(bits, hints); 
points = МО POINTS; 
}else { 
DetectorResult detectorResult = new Detector(image.getBlackMatrix()).detect(hints); 
decoderResult = decoder.decode(detectorResult.getBits(), hints); 
points = detectorResult.getPoints(); 
} 
Result result = new Result(decoderResult.getText(), decoderResult.getRawBytes(), points, 
BarcodeFormat.QR_CODE); 
List<byte[ ]> byteSegments = decoderResult.getByteSegments(); 
if (byteSegments != null) { 
result.putMetadata(ResultMetadataType.BYTE SEGMENTS, byteSegments); 
} 
String ecLevel = decoderResult.getECLevel(); 
if (ecLevel != null) { 
result.putMetadata(ResultMetadataType.ERROR CORRECTION LEVEL, ecLevel); 
) 
return result; 
} 
@Override 
public void reset() { 
/ do nothing 
} 
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private static BitMatrix extractPureBits(BitMatrix image) throws NotFoundException { 
int[] leftTopBlack = image.getTopLeftOnBit(); 
int[] rightBottomBlack = image.getBottomRightOnBit(); 
if (leftTopBlack == null || rightBottomBlack == null) { 
throw NotFoundException.getNotFoundinstance(); 
} 


int moduleSize = moduleSize(leftTopBlack, image); 


int top = leftTopBlack[1]; 

int bottom = rightBottomBlack[1]; 
int left = leftTopBlack[0]; 

int right = rightBottomBlack[0]; 


if (bottom - top != right - left) { 
/特殊 情况 下 ， 在 右 下 角 的 模块 是 不 是 黑色 的 
right = left + (bottom - top); 

) 


int matrix Width = (right - left + 1) / moduleSize; 
int matrixHeight = (bottom - top + 1) / moduleSize; 
if (matrixWidth <= 0 || matrixHeight <= 0) ( 
throw NotFoundException.getNotFoundinstance(); 
) 
if (matrixHeight != matrixWidth) { 
11 Only possibly decode square regions 
throw NotFoundException.getNotFoundinstance(); 


) 
// 短 暂 关闭 ， 这 将 有 助 于 恢复 
int nudge = moduleSize >> 1; 
top += nudge; 
left += nudge; 
// 只 要 读 出 位 
BitMatrix bits = new BitMatrix(matrixWidth, matrixHeight); 
for (int y = 0; y < matrixHeight; y++) { 
int iOffset = top + y * moduleSize; 
for (int x = 0; x < matrixWidth; x++) { 
if (image.get(left + x * moduleSize, iOffset)) { 
bits.set(x, y); 
} 
} 
} 
return bits; 
} 
private static int moduleSize(int[ ] leftTopBlack, BitMatrix image) throws NotFoundException { 
int height = image.getHeight(); 
int width = image.getWidth(); 
int x = leftTopBlack[0]; 
int y = leftTopBlack[1]; 
while (x < width && y < height && image.get(x, y)) { 
xtt 
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у++; 
} 
if (x == width || y == height) { 

throw NotFoundException.getNotFoundinstance(); 
} 
int moduleSize = x - leftTopBlack[0]; 
if (moduleSize == 0) { 

throw NotFoundException.getNotFoundlnstance(); 
} 


retum moduleSize; 


18.3 编码 处 理 


知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 18 章 \ 编 码 处 理 .avi 
编码 处 理 的 过 程 和 解码 处 理 的 过 程 相反 ， 是 指 将 采集 到 的 信息 编码 成 QR 二 维 码 的 形式 。 在 本 节 
的 内 容 中 ， 将 详细 讲解 编码 处 理 的 具体 实现 流程 。 


18.3.1 Encoder 处 理 


编写 文件 EncoderActivityjava， 功 能 是 使 用 Encoder 将 采集 到 的 信息 转换 为 QR 码 ， 有 具体 实现 代码 
如 下 所 示 。 
public final class EncoderActivity extends Activity { 


private static final String TAG = EncoderActivity.class.getSimpleName(); 


@Override 

public void onCreate(Bundle bundle) { 
super.onCreate(bundle); 
setContentView(R.layout.encoder); 


/假设 全 屏 视图 时 的 操作 

WindowManager manager = (WindowManager) getSystemService(WINDOW_SERVICE); 
Display display = manager.getDefaultDisplay(); 

int width = display.getWidth(); 

int height = display.getHeight(); 

int smallerDimension = width < height ? width : height; 

smallerDimension = smallerDimension * 7 / 8; 


try { 
QRCodeEncoder qrCodeEncoder = null; 
I| qrCodeEncoder = new QRCodeEncoder("AT", null, Contents. Type. TEXT, 
11 BarcodeFormat.CODABAR .toString(), smallerDimension); 
11 qrCodeEncoder = new QRCodeEncoder("HI", null, Contents. Type. TEXT, 
11 BarcodeFormat.CODE_39.toString(), smallerDimension); 
11 qrCodeEncoder = new QRCodeEncoder("Hello", null, 
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11 Contents.Type.TEXT, BarcodeFormat.CODE_128.toString(), 

ll smallerDimension); 

ll qrCodeEncoder = new QRCodeEncoder("123456789101 1", null, 

11 Contents.Type.TEXT, BarcodeFormat.EAN 13.toString(), 

ll smallerDimension); 

11 qrCodeEncoder = new QRCodeEncoder("12345678", null, 

II Contents.Type.TEXT, BarcodeFormat.EAN 8.toString(), 

ll smallerDimension); 

I| qrCodeEncoder = new QRCodeEncoder("1234", null, 

11 Contents.Type.TEXT, BarcodeFormat.ITF .toString(), 

ll smallerDimension); 

11 qrCodeEncoder = new QRCodeEncoder("2345", null, 

11 Contents.Type.TEXT, BarcodeFormat.PDF 417.toString(), 

ll smallerDimension); 

qrCodeEncoder = new QRCodeEncoder("Hello", null, Contents.Type. TEXT, BarcodeFormat.QR_ 
CODE.toString(), smallerDimension); 

ll qrCodeEncoder = new QRCodeEncoder("12345678910", null, 

11 Contents.Type.TEXT, BarcodeFormat.UPC_A.toString(), 

ll smallerDimension); 


Bitmap bitmap = qrCodeEncoder.encodeAsBitmap(); 
ImageView view = (ImageView) findViewByld(R.id.image_view); 
view.setlmageBitmap(bitmap); 


TextView contents = (TextView) findViewByld(R.id.contents text view); 
contents.setText(qrCodeEncoder.getDisplayContents()); 
setTitle(getString(R.string.app name) + " - " + qrCodeEncoder.getTitle()); 
) catch (WriterException e) ( 
Log.e(TAG, "Could not encode barcode", e); 
} catch (IllegalArgumentException e) { 
Log.e(TAG, "Could not encode barcode", e); 
) 
} 
} 
在 上 述 代码 中 加 载 显示 了 布局 文件 encoder.xml 中 的 Ul 控件 ， 具 体 实现 代码 如 下 所 示 。 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/encode_view" 
android:layout width-"fill parent" 
android:layout_height="fill_ parent" 
android:fillViewport-"true" 
android:background="@color/encode_view" 
android:orientation="vertical" 
android:gravity="center"> 
«ImageView android:id="@+id/image_view" 
android:layout_width="fill_ parent" 
android:layout height-"wrap content" 
android:layout gravity-"center horizontal" 
android:scaleType-"center" 
android:contentDescription="@string/barcode_image"/> 
«ScrollView android:layout_width="fill_parent" 
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android:layout_height="wrap_content" 
android:layout_gravity="center_horizontal" 
android:gravity-"center"» 

«TextView android:id-"(g)*id/contents text view" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout gravity-"center horizontal" 
android:gravity="center" 
android:textColor="@color/contents_text" 
android:textSize="18sp" 
android:paddingBottom="8dip" 
android:paddingLeft="8dip" 
android:paddingRight="8dip"/> 

</ScrollView> 
</LinearLayout> 


18.3.2 生成 QR 二 维 码 


编写 文件 Encoderjava， 功 能 是 以 指定 的 编码 模式 生成 QR 二 维 码 。 可 以 在 chooseMode 内 部 选择 
编码 模式 ， 编 码 成 功 后 被 存储 在 QRCode 结果 集中 。 在 此 建议 使 用 QRCode.EC LEVEL L (最 低级 ) 
模式 ， 因 为 我 们 的 主要 用 途 是 显示 QR 码 上 的 桌面 屏幕 。 如 果 需 要 非常 强 的 纠 错 功能 ， 可 以 选择 其 他 
的 模式 。 文 件 Encoderjava 的 具体 实现 代码 如 下 所 示 。 
public final class Encoder { 
II The original table is defined in the table 5 of JISX0510:2004 (p.19). 
private static final int[ ] ALPHANUMERIC TABLE = { -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, 
11 0x00-0x0f 
-1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, // 0x10-0x1f 
36, -1, -1, -1, 37, 38, -1, -1, -1, -1, 39, 40, -1, 41, 42, 43, // 0x20-0x2f 
0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 44, -1, -1, -1, -1, -1, // Ox30-0x3f 
-1, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, // 0x40-0x4f 
25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, -1, -1, -1, -1, -1, // 0x50-0x5f 
н 


static final String DEFAULT_BYTE_MODE_ENCODING = "ISO-8859-1"; 


private Encoder() { 
} 


11 The mask penalty calculation is complicated. See Table 21 of 

ЇЇ JISX0510:2004 (p.45) for 

II details. 

II Basically it applies four rules and summate all penalties. 

private static int calculateMaskPenalty(ByteMatrix matrix) { 
int penalty = 0; 
penalty += MaskUtil.applyMaskPenaltyRule1 (matrix); 
penalty += MaskUtil.applyMaskPenaltyRule2(matrix); 
penalty += MaskUtil.applyMaskPenaltyRule3(matrix); 
penalty += MaskUtil.applyMaskPenaltyRule4(matrix); 
return penalty; 
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} 
public static void encode(String content, ErrorCorrectionLevel ecLevel, QRCode qrCode) throws 


WriterException { 
encode(content, ecl evel, null, qrCode); 


} 


public static void encode(String content, ErrorCorrectionLevel ecLevel, Map<EncodeHintType, ?> hints, 
QRCode qrCode) throws WriterException { 


String encoding = hints == null ? null : (String) hints.get(EncodeHintType.CHARACTER_SET); 
if (encoding == null) { 

encoding = DEFAULT_BYTE_MODE_ENCODING; 
} 


11 Step 1: Choose the mode (encoding) 
Mode mode = chooseMode(content, encoding); 


II Step 2: Append "bytes" into "dataBits" in appropriate encoding 
BitArray dataBits = new BitArray(); 
appendBytes(content, mode, dataBits, encoding); 


II Step 3: Initialize QR code that can contain "dataBits" 
int numInputBits = dataBits.getSize(); 
initQRCode(numlnputBits, ecLevel, mode, qrCode); 


II Step 4: Build another bit vector that contains header and data 
BitArray headerAndDataBits 7 new BitArray(); 


/ Step 4.5: Append ECI message if applicable 
if (mode == Mode.BYTE && IDEFAULT BYTE MODE ENCODING.equals(encoding)) { 
CharacterSetECI есі = CharacterSetECI.getCharacterSetECIByName(encoding); 
if (eci != null) ( 
appendECl(eci, headerAndDataBits); 
) 
) 


appendModelnfo(mode, headerAndDataBits); 


int numLetters = mode == Mode.BYTE ? dataBits.getSizelnBytes() : content.length(); 
appendLengthinfo(numLetters, qrCode.getVersion(), mode, headerAndDataBits); 
headerAndDataBits.appendBitArray(dataBits); 


/ Step 5: Terminate the bits properly 
terminateBits(qrCode.getNumDataBytes(), headerAndDataBits); 


II Step 6: Interleave data bits with error correction code 

BitArray finalBits = new BitArray(); 

interleaveWithECBytes(headerAndDataBits, qrCode.getNumTotalBytes(), qrCode.getNumDataBytes(), 
qrCode.getNumRSBlocks(), finalBits); 


II Step 7: Choose the mask pattern and set to "qrCode" 
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ByteMatrix matrix = new ByteMatrix(qrCode.getMatrixWidth(), qrCode.getMatrixWidth()); 
qrCode.setMaskPattern(chooseMaskPattern(finalBits, ecLevel, qrCode.getVersion(), matrix)); 


II Step 8. Build the matrix and set it to "qrCode" 
Matrix Util.buildMatrix(finalBits, ecLevel, qrCode.getVersion(), qrCode.getMaskPattern(), matrix); 
qrCode.setMatrix(matrix); 


II Step 9. Make sure we have a valid QR Code 
if (IqrCode.isValid()) ( 

throw new WriterException("Invalid QR code: " * qrCode.toString()); 
) 


static int getAlphanumericCode(int code) ( 


} 


if (code < ALPHANUMERIC_TABLE. length) { 
return ALPHANUMERIC TABLE[code]; 
) 


return -1; 


public static Mode chooseMode(String content) ( 


} 


return chooseMode(content, null); 


private static Mode chooseMode(String content, String encoding) { 


} 


if ("Shift_JIS".equals(encoding)) { 
11 Choose Kanji mode if all input are double-byte characters 
return isOnlyDoubleByteKanji(content) ? Mode.KANJI : Mode.BYTE; 
} 
boolean hasNumeric = false; 
boolean hasAlphanumeric = false; 
for (int i = 0; i < content.length(); ++i) ( 
char c = content.charAt(i); 
if (с >='0' && с <= '9') ( 
hasNumeric = true; 
} else if (getAlphanumericCode(c) != -1) { 
hasAlphanumeric = true; 


) else { 
return Mode.BYTE; 
} 
} 
if (hasAlphanumeric) { 
return Mode.ALPHANUMERIC; 
) 
if (hasNumeric) ( 
return Mode.NUMERIC; 
) 
return Mode.BYTE; 


private static boolean isOnlyDoubleB yteKanji(String content) { 


byte[] bytes; 
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try { 
bytes = content.getBytes("Shift JIS"); 
} catch (UnsupportedEncodingException uee) { 
return false; 
} 
int length = bytes.length; 
if (length % 2 != 0) { 
return false; 
} 
for (int i = 0; i < length; i += 2) { 
int byte1 = bytes[i] & OxFF; 
if ((byte1 < 0x81 || byte1 > Ox9F) && (byte1 < OxEO || byte1 > OxEB)) { 
return false; 
} 
} 
return true; 


} 


private static int chooseMaskPattern(BitArray bits, ErrorCorrectionLevel ecLevel, int version, ByteMatrix 
matrix) throws WriterException { 


int minPenalty = Integer. MAX VALUE; // Lower penalty is better. 
int bestMaskPattern = -1; 
11 We try all mask patterns to choose the best one 
for (int maskPattern = 0; maskPattern « QRCode.NUM MASK PATTERNS; maskPattern++) { 
MatrixUtil.buildMatrix(bits, ecLevel, version, maskPattern, matrix); 
int penalty = calculateMaskPenalty (matrix); 
if (penalty < minPenalty) ( 
minPenalty = penalty; 
bestMaskPattern = maskPattern; 
} 
} 
return bestMaskPattern; 
} 
private static void initQRCode(int numinputBits, ErrorCorrectionLevel ecLevel, Mode mode, QRCode 
qrCode) throws WriterException { 
qrCode.setECLevel(ecLevel); 
qrCode.setMode(mode); 


II In the following comments, we use numbers of Version 7-H 
for (int versionNum = 1; versionNum <= 40; versionNum++) { 
Version version 7 Version.getVersionForNumber(versionNum); 
// numBytes = 196 
int numBytes = version.getTotalCodewords(); 
II getNumECBytes = 130 
Version.ECBlocks ecBlocks = version.getECBlocksForLevel(ecLevel); 
int numEcBytes = ecBlocks.getTotalEC Codewords(); 
11 getNumRSBlocks = 5 
int numRSBlocks = ecBlocks.getNumBlocks(); 
// getNumDataBytes = 196 - 130 = 66 
int numDataBytes = numBytes - numEcBytes; 
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II We want to choose the smallest version which can contain data of 

//"numinputBytes" + 

II some 

II extra bits for the header (mode info and length info). The header 

II can be three bytes 

II (precisely 4 + 16 bits) at most 

if (numDataBytes >= getTotallnputBytes(numInputBits, version, mode)) { 
11 Yay, we found the proper rs block info! 
qrCode.setVersion(versionNum); 
qrCode.setNumTotalBytes(numBytes); 
qrCode.setNumDataBytes(numDataBytes); 
qrCode.setNumRSBlocks(numRSBlocks); 
11 getNumECBytes = 196 - 66 = 130 
qrCode.setNumECBytes(numEcBytes); 
JI matrix width = 21 + 6 * 4 = 45 
qrCode.setMatrixWidth(version.getDimensionForVersion()); 
return; 

) 

} 
throw new WriterException("Cannot find proper rs block info (input data too big?)"); 
} 


private static int getTotallnputBytes(int numInputBits, Version version, Mode mode) { 
int modelnfoBits = 4; 
int charCountBits = mode.getCharacterC ountBits(version); 
int headerBits = modelnfoBits + charCountBits; 
int totalBits  numInputBits + headerBits; 


return (totalBits 7) / 8; 
} 


p 
* 终止 位 在 8.4.8 和 8.4.9 之 间 
" 
static void terminateBits(int numDataBytes, BitArray bits) throws WriterException { 
int capacity = numDataBytes << 3; 
if (bits.getSize() > capacity) { 


throw new WriterException("data bits cannot fit in the QR Code" + bits.getSize() + " >" + capacity); 


} 

for (int i = 0; i < 4 && bits.getSize() < capacity; ++i) { 
bits.appendBit(false); 

} 

II Append termination bits. See 8.4.8 of JISX0510:2004 (p.24) for 

II details. 

11 If the last byte isn't 8-bit aligned, we'll add padding bits. 

int numBitsInLastByte = bits.getSize() & 0x07; 


if (numBitsInLastByte > 0) í 
for (int i = numBitsInLastByte; i < 8; i++) { 
bits.appendBit(false); 
} 
} 
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II lf we have more space, we'll fill the space with padding patterns 
II defined in 8.4.9 
II (p.24). 
int numPaddingBytes = numDataBytes - bits.getSizelnBytes(); 
for (int i = 0; i < numPaddingBytes; ++i) { 
bits.appendBits((i & 0x01) == 0 ? OxEC : 0x11, 8); 
} 
if (bits.getSize() != capacity) { 
throw new WriterException("Bits size does not equal capacity"); 
} 
} 


p 
* 得 到 的 数据 字 节 和 纠 错 的 数字 节 数 块 
ff 
static void getNumDataBytesAndNumECB ytesForBlockID(int numTotalBytes, int numDataBytes, int 
numRSBlocks, int blockID, int[ ] numDataBytesInBlock, 

int[ ] numECBytesInBlock) throws WriterException { 

if (blockID >= numRSBlocks) ( 
throw new WriterException("Block ID too large"); 

} 

II numRsBlocksInGroup2 = 196 96 5 = 1 

int numRsBlocksInGroup2 = numTotalBytes % numRSBlocks; 

1/ numRsBlocksInGroup1 = 5 - 1 = 4 

int numRsBlocksInGroup1 = numRSBlocks - numRsBlocksInGroup2; 

II numTotalBytesInGroup1 = 196 / 5 = 39 

int numTotalBytesInGroup1 = numTotalBytes / numRSBlocks; 

1/ numTotalBytesInGroup2 = 39 + 1 = 40 

int numTotalBytesInGroup2 = numTotalBytesInGroup1 + 1; 

II numDataBytesInGroup1 = 66 / 5 = 13 

int numDataBytesInGroup1 = numDataBytes / numRSBlocks; 

II numDataBytesInGroup2 = 13 + 1 = 14 

int numDataBytesInGroup2 = numDataBytesInGroup1 + 1; 

11 numEcBytesInGroup1 = 39 - 13 = 26 

int numEcBytesInGroup1 = numTotalBytesInGroup1 - numDataBytesInGroup1; 

// numEcBytesInGroup2 = 40 - 14 = 26 

int numEcBytesInGroup2 = numTotalBytesInGroup2 - numDataBytesInGroup2; 

II Sanity checks. 

1126 = 26 

if (numEcBytesInGroup1 != numEcBytesInGroup2) { 
throw new WriterException("EC bytes mismatch"); 

} 

/5=4+1 

if (numRSBlocks != numRsBlocksInGroup1 + numRsBlocksInGroup2) ( 
throw new WriterException("RS blocks mismatch"); 

) 

11 196 = (13 + 26)* 4 + (14 + 26)* 1 

if (numTotalBytes != ((numDataBytesInGroup1 + numEcBytesInGroup1) * numRsBlocksInGroup1 ) 

* ((numDataBytesInGroup2 * numEcBytesInGroup2) * numRsBlocksInGroup2)) ( 

throw new WriterException("Total bytes mismatch"); 


e 
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if (blockID < numRsBlocksInGroup1) { 
numDataBytesInBlock[0] = numDataBytesInGroup1 ; 
numECBytesInBlock[0] = numEcBytesInGroup1; 

) else { 
numDataBytesInBlock[0] = numDataBytesInGroup2; 
numECBytesInBlock[0] = numEcBytesInGroup2; 

} 


} 
static void interleaveWithEC Bytes(BitArray bits, int numTotalBytes, int numDataBytes, int numRSBlocks, 


BitArray result) throws WriterException { 


11 "bits" must have "getNumDataBytes" bytes of data 
if (bits.getSizeInBytes() != numDataBytes) ( 

throw new WriterException("Number of bits and data bytes does not match"); 
} 


/分 割 数 据 字 节 成 块 ， 并 为 它们 生成 纠 错字 节 

// 将 存储 划分 字 节 的 数据 块 和 纠 错字 节 块 存储 到 “ 块 ” 
int dataBytesOffset = 0; 

int maxNumDataBytes = 0; 

int maxNumEcBytes = 0; 


/根据 reedsolmon 块 的 数量 值 来 初始 化 向 量 
Collection<BlockPair> blocks = new ArrayList<BlockPair>(numRSBlocks); 


for (int i = 0; i< numRSBlocks; ++i) { 
int[ ] numDataBytesInBlock = new int[1]; 
int[ ] numEcBytesInBlock = new int[1]; 
getNumDataBytesAndNumECBytesForBlockl D(numTotalBytes, numDataBytes, numRSBlocks, i, 
numDataBytesInBlock, numEcBytesInBlock); 


int size = numDataBytesInBlock[0]; 

byte[ ] dataBytes = new byte[size]; 

bits.toBytes(8 * dataBytesOffset, dataBytes, 0, size); 

byte[ ] ecBytes = generateECBytes(dataBytes, numEcBytesInBlock[0]); 
blocks.add(new BlockPair(dataBytes, ecBytes)); 


maxNumDataBytes = Math.max(maxNumDataBytes, size); 
maxNumEcBytes = Math.max(maxNumEcBytes, ecBytes.length); 
dataBytes Offset += numDataBytesInBlock[0]; 

} 

if (numDataBytes != dataBytesOffset) { 
throw new WriterException("Data bytes does not match offset"); 


} 


/数据 块 处 理 
for (int i = 0;i< maxNumDataBytes; ++i) { 
for (BlockPair block : blocks) { 
byte[ ] dataBytes = block.getDataBytes(); 
if (i « dataBytes.length) ( 
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result.appendBits(dataBytes[i], 8); 
} 


} 
// 纠 错 块 处 理 
for (int i = 0; i < maxNumEcBytes; ++i) { 
for (BlockPair block : blocks) { 
byte[ ] ecBytes = block.getErrorCorrectionBytes(); 
if (i < ecBytes.length) { 
result.appendBits(ecBytes[i], 8); 
} 
} 


} 
if (numTotalBytes != result.getSizelnBytes()) { // Should be same. 


throw new WriterException("Interleaving error: " + numTotalBytes +" and" + result.get 
SizelnBytes() + " differ."); 
} 
} 
static byte[ ] generateECBytes(byte[ ] dataBytes, int numEcBytesInBlock) { 
int numDataBytes = dataBytes.length; 
int[ ] toEncode = new int[numDataBytes + numEcBytesInBlock]; 
for (int i = 0; i < numDataBytes; i++) { 
toEncode[i] = dataBytes[i] & OxFF; 
) 
new ReedSolomonEncoder(GenericGF.QR CODE FIELD 256).encode(toEncode, numEcByteslnBlock); 
byte[ ] ecBytes = new byte[numEcByteslInBlock]; 
for (int i = 0; i < numEcByteslnBlock; i++) ( 
ecBytes[i] = (byte) toEncode[numDataBytes + i]; 
) 
return ecBytes; 
) 
p 
* 追 加 模式 信息 。 如 果 成 功 ， 将 结果 存储 在 “位 ” 
gi 
static void appendModelnfo(Mode mode, BitArray bits) { 
bits.appendBits(mode.getBits(), 4); 
} 
p 
追加 长 度 的 信息 。 成 功 时 ， 存 储 在 “位 ”的 结果 
/ 
static void appendLengthlInfo(int numLetters, int version, Mode mode, BitArray bits) throws WriterException { 
int numBits = mode.getCharacterCountBits(Version.getVersionForNumber(version)); 
if (numLetters > ((1 << numBits) - 1)) { 
throw new WriterException(numLetters + "is bigger than" + ((1 << numBits) - 1)); 


* 
* 


} 
bits.appendBits(numLetters, numBits); 


} 


. 
* 在 “模式 ”模式 〈 编 码 ) 中 追加 “ 字 节 ”为 “比特 ”。 如 果 成 功 ， 则 将 结果 存储 在 “位 ” 
bik 
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static void appendBytes(String content, Mode mode, BitArray bits, String encoding) throws WriterException 


switch (mode) { 

case NUMERIC: 
appendNumericBytes(content, bits); 
break; 

case ALPHANUMERIC: 
appendAlphanumericBytes(content, bits); 
break; 

case BYTE: 
append8BitBytes(content, bits, encoding); 
break; 

case KANJI: 
appendKanjiBytes(content, bits); 
break; 

default: 
throw new WriterException("Invalid mode: " + mode); 

} 

} 


static void appendNumericBytes(CharSequence content, BitArray bits) ( 
int length = content.length(); 
int i = 0; 
while (i < length) { 
int num1 = content.charAt(i) - '0'; 
if (i + 2 < length) { 
ППО 位 编码 的 三 个 数字 字母 
int num2 = content.charAt(i + 1) - '0'; 
int num3 = content.charAt(i + 2) - '0'; 
bits.appendBits(num1 * 100 + num2 * 10 + num3, 10); 
i += 3; 
} else if (i + 1 < length) { 
/7 位 编码 的 两 个 数字 字母 
int num2 = content.charAt(i + 1) - '0'; 
bits.appendBits(num1 * 10 + num2, 7); 
i+=2; 
) else ( 
11 Encode one numeric letter in four bits 
bits.appendBits(num1, 4); 
itt 


) 


static void appendAlphanumericBytes(CharSequence content, BitArray bits) throws WriterException { 
int length 7 content.length(); 
inti = 0; 
while (i < length) { 
int code1 = getAlphanumericCode(content.charAt(i)); 
if (code1 == -1) { 
throw new WriterException(); 


9) 


= Android 外 设 开 发 实战 


} 

if (i + 1 < length) ( 
int code2 = getAlphanumericCode(content.charAt(i + 1)); 
if (code2 == -1) { 

throw new WriterException(); 

} 
11 Encode two alphanumeric letters in 11 bits 
bits.appendBits(code1 * 45 + code2, 11); 
i+=2; 

) else { 
II Encode one alphanumeric letter in six bits 
bits.appendBits(code1, 6); 


i++; 
} 
} 
} 
static void append8BitBytes(String content, BitArray bits, String encoding) throws WriterException { 
byte[ ] bytes; 
try( 


bytes = content.getBytes(encoding); 
) catch (UnsupportedEncodingException uee) ( 
throw new WriterException(uee.toString()); 
) 
for (byte b : bytes) ( 
bits.appendBits(b, 8); 


) 

} 

static void appendKanjiBytes(String content, BitArray bits) throws WriterException { 
byte[ ] bytes; 
try { 


bytes = content.getBytes("Shift_JIS"); 
} catch (UnsupportedEncodingException uee) { 
throw new WriterException(uee.toString()); 
} 
int length = bytes.length; 
for (int i = 0; i < length; i += 2) { 
int byte1 = bytes[i] & OxFF; 
int byte2 = bytes[i + 1] & OxFF; 
int code = (byte1 << 8) | byte2; 
int subtracted = -1; 
if (code >= 0x8140 && code <= Ox9ffc) ( 
subtracted = code - 0x8140; 
} else if (code >= 0xe040 && code <= Oxebbf) { 
subtracted = code - 0xc140; 
} 
if (subtracted == -1) { 
throw new WriterException("Invalid byte sequence"); 
} 
int encoded = ((subtracted >> 8) * 0xc0) + (subtracted & Oxff); 
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bits.appendBits(encoded, 13); 
} 
} 
private static void appendECl(CharacterSetECI есі, BitArray bits) { 
bits.appendBits(Mode.ECl.getBits(), 4); 
// 正 确 的 值 高 达 127 
bits.appendBits(eci.getValue(), 8); 
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知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 18 章 \ 信 息 分 享 .avi 
当 读 取 QR 码 中 的 信息 后 ， 可 以 向 里 面 添加 联系 信息 ， 并 将 生成 的 QR 二 维 码 与 邮箱 、 网 站 、 推 
特 或 某 个 应 用 程序 相连 接 。 在 本 节 的 内 容 中 ， 将 详细 讲解 信息 分 享 功能 的 具体 实现 流程 。 


18.4.1 通讯 录 处 理 
编写 文件 AddressBookResultHandlerjava 处 理 通讯 录 的 信息 ， 即 处 理 QR 码 的 地 址 项 信息 ， 有 具体 实 


现代 码 如 下 所 示 。 
public final class AddressBookResultHandler extends ResultHandler { 


private static final DateFormat[ ] DATE FORMATS = { new SimpleDateFormat("yyyyMMdd", Locale.ENGLISH), 
new SimpleDateFormat("yyyyMMdd'T'HHmmss", Locale.ENGLISH), new SimpleDateFormat 
("yyyy-MM-dd", Locale.ENGLISH), 
new SimpleDateFormat('yyyy-MM-dd'T'HH:mm:ss", Locale.ENGLISH), }; 


private final boolean{ ] fields; 


public AddressBookResultHandler(Activity activity, ParsedResult result) { 
super(activity, result); 
AddressBookParsedResult addressResult = (AddressBookParsedResult) result; 
String[ ] addresses = addressResult.getAddresses(); 
boolean hasAddress = addresses != null && addresses.length > 0 && addresses[0].length() > 0; 
String[ ] phoneNumbers = addressResult.getPhoneNumbers(); 
boolean hasPhoneNumber = phoneNumbers != null && phoneNumbers.length > 0; 
String[ ] emails = addressResult.getEmails(); 
boolean hasEmailAddress = emails != null && emails.length > 0; 


fields = new boolean[4]; 
fields[0] = true; // Add contact is always available 
fields[1] = hasAddress; 
fields[2] = hasPhoneNumber; 
fields[3] = hasEmailAddress; 
} 


// 重 写 操作 ， 可 以 判断 是 电话 号 码 、 生 日 和 非常 规 的 名 字 等 格式 
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@Override 

public CharSequence getDisplayContents() { 
AddressBookParsedResult result = (AddressBookParsedResult) getResult(); 
StringBuilder contents = new StringBuilder(100); 
ParsedResult.maybeAppend(result.getNames(), contents); 
int namesLength = contents.length(); 


String pronunciation = result.getPronunciation(); 

if (pronunciation != null && pronunciation.length() > 0) { 
contents.append("\n("); 
contents.append(pronunciation); 
contents.append(')’); 

} 


ParsedResult.maybeAppend(result.getTitle(), contents); 
ParsedResult.maybeAppend(result.getOrg(), contents); 
ParsedResult.maybeAppend(result.getAddresses(), contents); 
String[ ] numbers = result.getPhoneNumbers(); 
if (numbers != null) { 
for (String number : numbers) { 
ParsedResult.maybeAppend(PhoneNumberUtils.formatNumber(number), contents); 
} 
} 
ParsedResult.maybeAppend(result.getEmails(), contents); 
ParsedResult.maybeAppend(result.getURL(), contents); 


String birthday = result.getBirthday(); 
if (birthday != null && birthday.length() > 0) ( 
Date date = parseDate(birthday); 
if (date != null) ( 
ParsedResult.maybeAppend(DateFormat.getDatelnstance().format(date.getTime()), contents); 
) 


} 
ParsedResult.maybeAppend(result.getNote(), contents); 


if (namesLength > 0) { 
Spannable styled = new SpannableString(contents.toString()); 
styled.setSpan(new StyleSpan(android.graphics.Typeface.BOLD), 0, namesLength, 0); 
return styled; 

) 

return contents.toString(); 


} 


private static Date parseDate(String s) { 
for (DateFormat currentFomat : DATE_FORMATS) { 
synchronized (currentFomat) { 
currentFomat.setLenient(false); 
Date result = currentFomat.parse(s, new ParsePosition(0)); 
if (result != null) { 
return result; 


} 


e 


第 18 章 QR 码 采集 器 


} 
} 
return null; 
} 
@Override 


public int getDisplayTitle() { 
return R.string.result address book; 
) 
} 


184.2 日 历 处 理 


编写 文件 CalendarResultHandlerjava 加 入 处 理 日 历 信 息 ,也 就 是 处 理 QR 码 的 日 历 项 信息 ， 有 具体 实 
现代 码 如 下 所 示 。 


public final class CalendarResultHandler extends ResultHandler { 


private static final DateFormat DATE_FORMAT = new SimpleDateFormat("yyyyMMdd", Locale.ENGLISH); 
private static final DateFormat DATE TIME FORMAT = new SimpleDateFormat("yyyyMMdd' T HHmmss", 
Locale.ENGLISH); 


public CalendarResultHandler(Activity activity, ParsedResult result) ( 
super(activity, result); 
) 


@Override 

public CharSequence getDisplayContents() { 
CalendarParsedResult calResult = (CalendarParsedResult) getResult(); 
StringBuilder result = new StringBuilder(100); 
ParsedResult.maybeAppend(calResult.getSummary(), result); 
Date start = calResult.getStart(); 
String startString = start.toGMTString(); 
appendTime(startString, result, false, false); 


Date end = calResult.getEnd(); 

String endString = end.toGMTString(); 

if (endString != null) { 
boolean sameStartEnd = startString.equals(endString); 
appendTime(endString, result, true, sameStartEnd); 

) 


ParsedResult.maybeAppend(calResult.getLocation(), result); 
ParsedResult.maybeAppend(calResult.getAttendees(), result); 
ParsedResult.maybeAppend(calResult.getDescription(), result); 
return result.toString(); 


} 


private static void appendTime(String when, StringBuilder result, boolean end, boolean sameStartEnd) { 


if (when.length() == 8) { 
K) 


// 只 显示 yearlmonth/day 格式 日 期 
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} 


} 


Date date; 
synchronized (DATE FORMAT){ 
date = DATE_FORMAT.parse(when, new ParsePosition(0)); 


} 
// 如 果 是 全 天 的 ， 这 是 结束 日 期 
if (end && !sameStartEnd) { 
date = new Date(date.getTime() - 24 * 60 * 60 * 1000); 
} 
ParsedResult.maybeAppend(DateFormat.getDatelnstance().format(date.getTime()), result); 


) else { 


// 本 地 时 间 
Date date; 
synchronized (DATE_TIME_FORMAT) { 
date = DATE_TIME_FORMAT.parse(when.substring(0, 15), new ParsePosition(0)); 
} 
long milliseconds = date.getTime(); 
if (when.length() == 16 && when.charAt(15) == 'Z') { 
Calendar calendar = new GregorianCalendar(); 
int offset = calendar.get(Calendar.ZONE OFFSET) + calendar.get(Calendar.DST OFFSET); 
milliseconds += offset; 
} 
ParsedResult.maybeAppend(DateFormat.getDateTimelnstance().format(milliseconds), result); 


@Override 
public int getDisplayTitle() { 


} 


return R.string.result calendar; 


18.4.3 ”处 理 邮箱 


编写 文件 EmailAddressResultHandlerjava， 功 能 是 将 邮箱 信息 生成 QR 二 维 码 ， 具 体 实现 代码 如 下 


所 示 。 


public final class EmailAddressResultHandler extends ResultHandler { 


public EmailAddressResultHandler(Activity activity, ParsedResult result) { 


} 


super(activity, result); 


@Override 
public CharSequence getDisplayContents() { 


EmailAddressParsedResult result = (EmailAddressParsedResult) getResult(); 
StringBuilder contents = new StringBuilder(100); 
ParsedResult.maybeAppend(result.getEmailAddress(), contents); 
contents.trimToSize(); 

return contents.toString(); 
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@Override 
public int getDisplayTitle() { 

return R.string.result_email_address; 
} 


} 
到 此 为 止 ， 整 个 实例 介绍 完 ， 有 关 URL 网 址 、SMS 信息 和 WiFi 二 维 码 的 生成 过 程 ， 请 读者 参考 
本 书 附 带 光 盘 中 的 具体 源码 。 本 项 目 执行 后 的 效果 如 图 18-1 所 示 。 
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18-1 执行 效果 
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随 着 国内 外 健身 运动 狂潮 的 兴起 , 纷纷 诞生 了 很 多 健身 运动 俱乐部 和 健身 组 织 , 例如 自驾 俱乐部 、 
登山 俱乐部 、 跑 吧 、 骑 行 俱 乐 部 等 。 为 了 更 好 地 了 解 自己 的 运动 轨迹 和 行走 路 线 ， 迫 切 需 要 开发 一 个 
能 够 记录 行走 或 行车 路 线 的 Android 应 用 程序 。 本 章 将 通过 一 个 综合 实例 的 实现 过 程 ， 详 细 讲 解 在 
Android 设备 中 开发 骑 行 记录 仪 的 方法 。 读 者 可 以 以 此 实例 为 基础 , 开发 其 他 类 似 的 行车 记录 仪 等 应 用 
程序 。 


19.1 选择 线路 规划 目的 地 


GH 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 19 章 \ 选 择 线路 规划 目的 地 .avi 
本 Android 应 用 程序 实例 提供 了 基于 GPS 线路 计划 和 定位 功能 ,支持 从 位 置 A 到 位 置 B 路 径 规划 ， 
并 且 可 以 查看 附近 位 置 的 单车 停放 处 ， 并 一 步 一 步 地 指示 行车 路 线 生成 路 线 图 ， 可 以 实现 卫星 导航 等 


实例 19-1 骑 行 记录 仪 光盘 :\codes\1BikeRoute 


19.1.1 系统 主 Activity 界面 


本 系统 的 主 界面 Activity 是 一 个 选择 线路 规划 目的 地 的 界面 ，Activity 实现 文件 是 Navigatejava， 
功能 是 获取 用 户 输 入 的 起 始 地 址 和 目的 地 地 址 ， 根 据 地 址 实现 路 线 规划 功能 。 文 件 Navigate java 的 具 
体 实现 代码 如 下 所 示 。 

public class Navigate extends Activity implements RouteListener { 

/* 起 始 地 址 框 */ 

private transient AutoCompleteTextView startAddressField; 
I" 目的 地 地 址 框 **/ 

private transient AutoCompleteTextView endAddressField; 
M 停车 管理 */ 

private Parking prk; 

Ibi EE **/ 

private AddressDatabase db; 

I je TRI 

public boolean isSearching; 

protected AbstractContactAccessor mContactAccessor; 
private Intent searchintent; 

protected BroadcastReceiver routeReceiver; 

protected BikeRouteApp app; 


private RoutePlannerTask search; 


РШЕ **/ 


private static boolean mShownDialog; 


”路 由 ID 产生 器 **/ 


Random random; 


@Override 

public final void onCreate(final Bundle savedinstanceState) { 
super.onCreate(savedInstanceState); 

random = new Random(); 

app = ((BikeRouteApp) getApplication()); 

mContactAccessor = AbstractContactAccessor.getinstance(); 
requestWindowFeature(Window.FEATURE RIGHT ICON); 

setContentView(R.layout.findplace); 
setFeatureDrawableResource(Window.FEATURE RIGHT ICON, R.drawable.ic bar bikeroute); 


searchintent = new Intent(); 


isSearching = false; 
mShownDialog = false; 


TT RU 
db = app.getDb(); 
prk = new Parking(this); 


/初始 化 域 

startAddressField = (AutoCompleteTextView) findViewByld(R.id.start_address_input); 
endAddressField = (AutoCompleteTextView) findViewByld(R.id.end_address_input); 
final Button searchButton = (Button) findViewByld(R.id.search_button); 


/初始 化 适配器 

final FindPlaceAdapter adapter = new FindPlaceAdapter(this, 
android.R.layout.simple dropdown item line); 

startAddressField.setAdapter(adapter); 

endAddressField.setAdapter(adapter); 


// 初 始 化 搜索 按钮 
searchButton.setOnClickListener(new SearchClickListener()); 


人 自动 填充 的 起 始 位 置 的 反 向 地 理 编码 */ 


/| 手柄 旋转 
final Object[ ] data = (Object[ ]) getLastNonConfigurationInstance(); 
if (data != null) { 
isSearching = (Boolean) data[2]; 
startAddressField.setText((String) data[3]); 
endAddressField.setText((String) data[4]); 
search = (RoutePlannerTask) data[5]; 
if(search != null) { 
search.setListener(this); 
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} 
} 


public void onStart() { 
super.onStart(); 
Thread t = new Thread() { 
public void run() { 
/初始 化 geocoder 
final Geocoder geocoder = new Geocoder(Navigate.this); 
/* 获 取 当 前 位 置 */ 
final LocationManager Im = (LocationManager)getSystemService(Context.LOCATION ` 
SERVICE); 


Location self = Im.getLastKnownLocation(LocationManager.GPS PROVIDER); 
if (self == null) ( 
self = Im.getLastKnownLocation(LocationManager. NETWORK PROVIDER); 


) 
if (self != null) ( 
try( 
final Address startAddress = geocoder.getFromLocation(self.getLatitude(), 
self.getLongitude(), 1).get(0); 
startAddressField.setText(StringAddress.asString(startAddress)); 
} catch (Exception e) ( 
Log.e(e.getMessage(), "FindPlace - location: " + self); 
) 
) 
) 
E 
t.run(); 
} 
p 
* 从 导航 请 求 文本 框 处 理 启动 地 址 地 理 编码 


* 通 过 路 线 规划 和 行动 ， 一 旦 计划 完成 后 生成 路 线 图 
qi 
private class SearchClickListener implements OnClickListener ( 
@Override 
public void onClick(final View view) { 
searchintent.putExtra(RoutePlannerlask.PLAN_TYPE, RoutePlannerTask.ADDRESS_PLAN); 
searchintent.putExtra(RoutePlannerlask.START_ ADDRESS, 
startAddressField.getText().toString()); 
searchlntent.putExtra(RoutePlannerTask.END ADDRESS, 
endAddressField.getText().toString()); 
requestRoute(); 
) 
) 


m 
* 重 写 处 理 旋转 跟踪 显示 对 话 框 
il 
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@Override 
protected void onPrepareDialog(final int id, final Dialog dialog) { 
super.onPrepareDialog(id, dialog); 
if (id == R.id.plan) { 
mShownDialog = true; 
} 
} 


p 
* 要 求 根据 规划 服务 的 路 线 注册 一 个 接收 器 来 处 理 它 
“il 
private void requestRoute() { 
searchintent.putExtra(RoutePlannerTask.ROUTE_ID, random.nextint(2147483647)); 
showDialog(R.id.plan); 
isSearching 7 true; 
search = new RoutePlannerTask(this, searchlntent); 
search.execute(); 


) 


p 
* 创 建 加 载 错 误 、 警 报 对 话 框 
qi 
@Override 
public Dialog onCreateDialog(final int id) { 
AlertDialog.Builder builder; 
ProgressDialog pDialog; 
Dialog dialog; 
switch(id) { 
case R.id.plan: 
pDialog = new ProgressDialog(this); 
pDialog.setCancelable(true); 
pDialog.setProgressStyle(ProgressDialog.STYLE SPINNER); 
pDialog.setMessage(getText(R.string.plan msg)); 
pDialog.setOnDismissListener(new OnDismissListener() ( 
@Override 
public void onDismiss(final DialogInterface arg0) { 
removeDialog(R.id.plan); 
if (INavigate.this.isSearching) { 
mShownDialog = false; 
} 
} 
» 
pDialog.setOnCancelListener(new OnCancelListener() ( 


@Override 
public void onCancel(final DialogInterface arg0) { 
search.cancel (true); 


} 


p; 
dialog = pDialog; 
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@ 


break; 
case R.id.plan fail: 
builder = new AlertDialog.Builder(this); 
builder.setMessage(getText(R.string.planfail_msg)).setCancelable( 
true).setPositiveButton(getString(R.string.ok), 
new DialogInterface.OnClickListener() { 


@Override 
public void onClick(final DialogInterface dialog, 
final int id) ( 
) 
» 
dialog 7 builder.create(); 


break; 
case R.id.ioerror: 
builder = new AlertDialog.Builder(this); 
builder.setMessage(getText(R.string.io error msg)).setCancelable( 
true).setPositiveButton(getString(R.string.ok), 
new DialogInterface.OnClickListener() { 


@Override 
public void onClick(final DialogInterface dialog, 
final int id) { 
dialog.dismiss(); 
} 
» 
dialog 7 builder.create(); 


break; 
case R.id.argerror: 
builder = new AlertDialog.Builder(this); 
builder.setMessage(getText(R.string.arg error msg)).setCancelable( 
true).setPositiveButton(getString(R.string.ok), 
new DialogInterface.OnClickListener() { 


@Override 
public void onClick(final DialogInterface dialog, 
final int id) ( 
dialog.dismiss(); 
) 
}; 
dialog = builder.create(); 


break; 
case R.id.reserror: 
builder = new AlertDialog.Builder(this); 
builder.setMessage(getText(R.string.result error msg)).setCancelable( 
true).setPositiveButton(getString(R.string.ok), 
new DialogInterface.OnClickListener() { 


@Override 
public void onClick(final DialogInterface dialog, 
final int id) { 
dialog.dismiss(); 
} 
» 
dialog = builder.create(); 


break; 
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case R.id.about: 
builder = new AlertDialog.Builder(this); 
builder.setMessage(getText(R.string.about_message)).setCancelable( 
true).setPositiveButton(getString(R.string.ok), 
new DialogInterface.OnClickListener() { 


@Override 
public void onClick(final DialogInterface dialog, 
final int id) { 
dialog.dismiss(); 
) 
» 
dialog = builder.create(); 
break; 
default: 
dialog = null; 
} 
return dialog; 
} 
p 
“创建 选 项 菜单 
а 
@Override 


public final boolean onCreateOptionsMenu(final Menu menu) { 
final Menulnflater inflater = getMenulnflater(); 
inflater.inflate(R.menu.navigate_menu, menu); 
return true; 


} 


@Override 
public final boolean onPrepareOptionsMenu(final Menu menu) { 
final Menultem steps = menu.findltem(R.id.directions); 
final Menultem back = menu.findltem(R.id.bike); 
final Menultem stand = menu.findltem(R.id.stand); 
steps.setVisible(false); 
if (app.getRoute() != null) ( 
steps.setVisible(true); 
} 
back.setVisible(false); 
stand.setVisible(false); 
if (startAddressField.getText().length() > 0) { 
stand.setVisible(true); 
if (prk.isParked()) { 
back.setVisible(true); 
} 
} 
return super.onPrepareOptionsMenu(menu); 
} 


p 
* 根据 用 户 选择 处 理事 件 程序 

* @retum true if option selected. 
‘i 
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@Override 
public boolean onOptionsltemSelected(final Menultem item) { 

Intent intent; 

Switch(item.getltemld()) { 

case R.id.prefs: 
intent = new Intent(this, Preferences.class); 
startActivity(intent); 
break; 

case R.id.directions: 
intent = new Intent(this, Directions View.class); 
startActivity(intent); 
break; 

case R.id.map: 
intent = new Intent(this, LiveRouteMap.class); 
startActivity(intent); 
break; 

case R.id.bike: 
searchintent.putExtra(RoutePlannerTask.PLAN TYPE, RoutePlannerTask.BIKE PLAN); 
searchlntent.putExtra(RoutePlannerTask.START ADDRESS, 

startAddressField.getText().toString()); 

requestRoute(); 
break; 

case R.id.stand: 
searchintent.putExtra(RoutePlannerTask.PLAN TYPE, RoutePlannerTask.STANDS PLAN); 
searchlntent.putExtra(RoutePlannerTask.START ADDRESS, 

startAddressField.getText().toString()); 

requestRoute(); 
break; 

case R.id.about: 
showDialog(R.id.about); 
break; 

case R.id.contacts: 
startActivityForResult(mContactAccessor.getPickContactintent(), 0); 

} 

return true; 


} 


p 
* 根据 搜索 任务 处 理 回调 函数 
sl 


@Override 
public void searchComplete(final Integer msg, final Route route) { 
if (msg != null) { 
try { 
dismissDialog(R.id.plan); 
} catch (Exception e) { 
Log.e("Navigate", e.getMessage()); 
} 
if (msg == R.id.result_ok) { 
db.insert(startAddressField.getText().toString()); 
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if (!"".equals(endAddressField.getText().toString())) { 
db.insert(endAddressField.getText().toString()); 


} 
final Intent map = new Intent(this, LiveRouteMap.class); 
app.setRoute(route); 
startActivity(map); 
) else { 
showDialog(msg); 
) 
) 
} 
p 
* 回 调处 理 用 户 选择 的 地 址 
di 
@Override 


protected void onActivityResult(final int requestCode, final int resultCode, final Intent data) { 
if (resultCode == RESULT_OK) { 
loadContactAddress(data.getData()); 
} 
} 


p 
* 在 后 台 载 入 存储 地 址 ， 并 设置 为 目的 地 
zi 
private void loadContactAddress(final Uri contactUri) { 
final AsyncTask«Uri, Void, String> task = new AsyncTask<Uni, Void, String>() { 


@Override 
protected String dolnBackground(Uri... uris) { 
return mContactAccessor.loadAddress(getContentResolver(), uris[0]); 


) 


@Override 
protected void onPostExecute(final String result) { 
endAddressField.setText(result); 
} 
А 


task.execute(contactUri); 


} 


p 
* 在 旋转 的 对 话 与 文本 框 中 重 写 保 存 的 搜索 任务 
7 
@Override 
public Object onRetainNonConfigurationInstance() { 
Object[ ] objs = new Object[6]; 
objs[1] = mShownDialog; 
objs[2] = isSearching; 
objs[3] = startAddressField.getText().toString(); 
objs[4] = endAddressField.getText().toString(); 


am 
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objs[5] = search; 
return objs; 

} 

@Override 

public void searchCancelled() { 
isSearching = false; 
search = null; 

} 

@Override 

public Context getContext() { 
return this; 

} 

} 


19.1.2. 布局 文件 capture.xml 


文件 Navigate.java 调用 的 布局 文件 是 capture.xml， 功 能 是 为 用 户 提供 输入 始 发 地 和 目的 地 地 点 的 
表单 。 文 件 findplace.xml 的 具体 实现 代码 如 下 所 示 。 


<?xml version="1.0" encoding="utf-8"?> 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:focusableln TouchMode-"true" 
android:focusable="true" 
android:orientation="vertical" 
android:layout_width="fill_ parent" 
android:layout_height="fill_ parent" 
android:gravity="center" 
android:paddingLeft="5px" 
android:paddingTop="5px" 
android:paddingRight="5px"> 
<com.nanosheep.bikeroute. view.StepView 
android:layout width-"fill parent" 
android:id="@+id/search" 
android:layout_height="wrap_content" 
android:orientation="vertical" 
android:gravity="center" 
android:layout_alignParentTop="true" 
android:padding="10px"> 

<TextView 
android:id="@+id/start_address_view" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="@string/start" 
android:gravity="center_vertical"> 
</TextView> 

<AutoCompleteTextView 
android:id="@+id/start_address_input" 
android:layout_width="fill_ parent" 
android:layout_height="wrap_content" 
android:hint="@string/start_input" 
android:textSize="18sp" 
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android:gravity="center" 
android:layout_below="@id/start_address_view"> 
</AutoCompleteTextView> 

<TextView 
android:id="@+id/end_address_view" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="@string/end" 
android:gravity="center_vertical" 
android:layout_below="@id/start_address_input"> 
</TextView> 

<AutoCompleteTextView 
android:id="@+id/end_address_input" 
android:layout_width="fill_ parent" 
android:layout_height="wrap_content" 
android:hint="@string/end_input" 
android:textSize="18sp" 
android:gravity="center" 

android:layout below="@id/end_ address view"> 
</AutoCompleteTextView> 

<Button 

android:id="@+id/search_ button" 
android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
android:text="@string/search" 
android:gravity="center" 


android:layout_below="@id/end_address_input"> 
</Button> 
</com.nanosheep.bikeroute.view.StepView> 
</LinearLayout> 


主 界面 的 执行 效果 如 图 19-1 所 示 。 


图 19-1 执行 效果 
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19.2 Adapter 适配器 处 理 


ЕЮ 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 19 章 \Adapter 适配器 处 理 .avi 

在 Android RiP, Adapter 是 连接 后 端 数据 和 前 端 显示 的 适配器 接口 ， 是 数据 和 UI (View) 之 间 
一 个 重要 的 纽带 ， 在 常见 的 View (List View,Grid View) 等 地 方 都 需要 用 到 Adapter。 在 本 实例 中 ， 需 
要 在 View 视图 中 显示 后 台地 址 数据 。 

文件 DirectionListAdapterjava 实现 位 置 方 向 适配器 处 理 ， 具 体 实现 代码 如 下 所 示 。 


p 


* 方 向 适配器 对 象 


ull 


public class DirectionListAdapter extends ArrayAdapter<Segment> { 


Г* 布局 inflater **/ 

private final transient Layoutinflater inflater; 

[КАЙ b e o 

private String unit; 

public DirectionListAdapter(final Context context, final int textView) ( 
super(context, textView); 
inflater = Layoutinflater.from(context); 
this.populate(); 


p 
* 将 当前 段 列表 填充 到 适配器 ， 清 除 任何 已 经 存在 的 数据 
E 
public void populate() ( 
clear(); 
final SharedPreferences settings = PreferenceManager.getDefaultSharedPreferences(getContext()); 
unit = settings.getString("unitsPref", "km"); 
BikeRouteApp app = (BikeRouteApp) getContext().getApplicationContext(); 
for (Segment s : app.getRoute().getSegments()) ( 
add(s); 
} 
} 


p. 
* 得 到 一 个 路 径 地 名 显示 视图 
*/ 


@Override 
public View getView(final int position, final View convertView, final ViewGroup parent) { 
final Segment segment = getltem(position); 
final View view = inflater.inflate(R.layout.direction item, null); 
final TextView turn = (TextView) view.findViewByld(R.id.tum); 
final TextView distance = (TextView) view.findViewByld(R.id.distance); 
final TextView length = (TextView) view.findViewByld(R.id.length); 
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tum.setText(segment.getInstruction()); 

if ("km".equals(unit)) { 
length.setText(Convert.asMeterString(segment.getLength())); 
distance.setText("(" + Convert.asKilometerString(segment.getLength()) + ")"); 


) else { 
length.setText(Convert.asFeetString(segment.getLength())); 
distance.setText("(" + Convert.asMilesString(segment.getLength()) + ")"); 
) 


return view; 
) 
) 
文件 FindPlaceAdapterjava 是 寻找 位 置 适 配器 文件 ， 功 能 是 检索 系统 中 所 需要 的 所 有 的 位 置信 息 ， 
具体 实现 代码 如 下 所 示 。 
public class FindPlaceAdapter extends ArrayAdapter<String> { 
private final Geocoder geocoder; 
号 以 前 的 地 址 数据 库 “*/ 
private final AddressDatabase db; 


public FindPlaceAdapter(final Context context, final int resource, 
final int txtViewResld) { 
super(context, resource, txtViewResld); 
geocoder = new Geocoder(context); 
db = ((BikeRouteApp) context.getApplicationContext()).getDb(); 
} 


public FindPlaceAdapter(final Context context, final int resource) { 
super(context, resource); 
geocoder = new Geocoder(context); 
db = ((BikeRouteApp) context.getApplicationContext()).getDb(); 
} 


p 
* 从 地 理 编码 服务 检索 数据 以 取代 ArrayAdapter 过 滤器 
* @retum a Filter object 
vil 


@Override 

public Filter getFilter() { 
return new GeoFilter(); 

} 


p 
* 伪 滤波 器 ， 返 回 基于 输入 的 字符 序列 的 地 址 


private class GeoFilter extends Filter { 
private List<Address> addresses; 
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public GeoFilter() { 


super(); 
addresses = new ArrayList<Address>(); 


} 
pe 
* 执 行 一 个 SQL 语句 , 在 SQL 语句 中 使 用 字符 序列 作为 一 个 地 理 编码 ， 过 滤 掉 系统 中 保存 的 以 前 的 检 
索 码 信息 */ 
@Override 


protected Filter. FilterResults performFiltering(final CharSequence ch) { 
final Filter.FilterResults res = new Filter.FilterResults(); 
final Set<String> results = new HashSet<String>(); 
if (ch == null) { 
res.count = 0; 
) else { 
final String адагеѕѕіприї = ch.toString(); 


/IAdd results from db 

results.addAll(db.selectLike(ch)); 

IISearch using geocoder 

try { 
addresses = geocoder.getFromLocationName(addressInput, 5); 
for (Address address : addresses) { 

results.add(StringAddress.asString(address)); 

} 


res.count = results.size(); 
res.values = results; 
} catch (IOException e) { 
res.count = -1; //pass result back to ui thread to show message 


} 
} 
return res; 
} 
p 
* 显示 结果 


si 
()SuppressWarnings("unchecked") 
@Override 
protected void publishResults(final CharSequence constraint, 
final FilterResults results) { 
if (results.count > 0) { 
clear(); 
for (String address : (Set<String>) results.values) { 
add(address); 
} 
FindPlaceAdapter.this.notifyDataSetChanged(); 
} else if (results.count == -1) { 
//Show an io error message if an exception was thrown 


@ 
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/((Activity) getContext()).showDialog(R.id.ioerror); 

FindPlaceAdapter.this.notifyDataSetInvalidated(); 
) else { 

FindPlaceAdapter.this.notifyDataSetlnvalidated(); 
5 
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知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 19 章 \ 生 成 路 线 图 .avi 
本 实例 的 核心 功能 是 生成 需要 的 行驶 路 线 图 ， 此 功能 需要 调用 Android 系统 的 地 图 定位 功能 ， 并 
且 还 需要 借助 本 系统 的 导航 服务 功能 。 在 本 节 的 内 容 中 ， 将 详细 讲解 生成 路 线 图 功能 的 实现 过 程 。 


19.3.1 实时 导航 服务 


文件 NavigationService.java 的 功能 是 提供 实时 的 导航 服务 ， 并 使 用 GPS 和 通知 更 新 反映 路 径 中 的 
当前 位 置 。 文 件 NavigationService java 的 具体 实现 代码 如 下 所 示 。 
public class NavigationService extends Service implements LocationListener{ 
private final [Binder mBinder = new LocalBinder(); 
private NotificationManager mNM; 
private LocationManager mLocationManager; 
private BikeRouteApp app; 
private Notification notification; 
private PendingIntent contentintent; 
public class LocalBinder extends Binder ( 
public NavigationService getService() ( 
return NavigationService.this; 
} 
} 


f* (non-Javadoc) 
* @see android.app.Service#onBind(android.content.|ntent) 
«i 
@Override 
public IBinder onBind(Intent arg0) { 
return mBinder; 
} 


@Override 
public void onCreate() { 
mNM = (NotificationManager)getSystemService(NOTIFICATION_SERVICE); 
/* Get location manager. */ 
mLocationManager = (LocationManager)getSystemService(Context.LOCATION_SERVICE); 


app = (BikeRouteApp) getApplication(); 
int icon = R.drawable.bikeroute; 
© 
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CharSequence tickerText = ""; 
long when = System.currentTimeMillis(); 


notification = new Notification(icon, tickerText, when); 
notification.flags |= Notification. FLAG ONGOING EVENT; 
Intent notificationIntent = new Intent(this, LiveRouteMap.class); 
notificationIntent. putExtra(getString(R.string.jump_intent), true); 
contentintent = PendingIntent.getActivity(this, 0, notificationIntent, 0); 
mLocationManager.requestLocationUpdates(LocationManager.GPS PROVIDER, 0, 0, this); 
if (app.getRoute() != null) { 
notification.setL atestEventlnfo(app, getText(R.string.notify title), 
app.getSegment().getlnstruction(), contentintent); 
mNM.notify(R.id.notifier, notification); 
) 
} 


@Override 

public int onStartCommand(Intent intent, int flags, int startld) ( 
Log.i("LocalService", "Received start іа " + startld + ": " + intent); 
II We want this service to continue running until it is explicitly 
II stopped, so return sticky 
return START STICKY; 

) 


@Override 
public void onDestroy() { 
mLocationManager.removeUpdates(this); 


mNM.cancelAll(); 

} 

p 

* 监听 位 置 更 新 ， 并 及 时 反馈 到 路 线 图 中 ， 然 后 在 更 新 状态 栏 中 发 布 提醒 信息 
7 

@Override 


public void onLocationChanged(Location location) { 
if (app.getRoute() != null) ( 
Intent update = new Intent((String) getText(R.string.navigation_intent)); 
// 找 到 最 近 的 点 
GeoPoint self = new GeoPoint(location); 
List<GeoPoint> near = app.getRoute().nearest(self, 2); 


double range = range(self, near.get(0), near.get(1)) - 50; 
double accuracy = location.getAccuracy(); 
if (range > accuracy) ( 
update.putExtra((String) getText(R.string.replan), true); 
String logMsg = "Range=" + range + ",Self="+self+",near points:" + near + "near points dist=" + 
near.get(0).distanceTo(near.get(1)) + ",ассигасу=" + accuracy; 
Log.e("Replanned", logMsg); 
notification.setLatestEventinfo(app, getText(R.string.notify_title), 
getText(R.string.replanning), contentintent); 
} else if (near.get(0).equals(app.getRoute().getEndPoint())) { //If we've arrived, shutdown and signal. 


@ 
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update.putExtra((String) getText(R.string.arrived), true); 

notification.setLatestEventinfo(app, getText(R.string.notify title), 
getText(R.string.arrived), contentIntent); 

) else{ 

update.putExtra((String) getText(R.string.point), near.get(0)); 

app.setSegment(app.getRoute().getSegment(near.get(0))); 

notification.setL atestEventInfo(app, getText(R.string.notify title), 
app.getSegment().getInstruction(), contentIntent); 


} 
sendBroadcast(update); 
mNM.notify(R.id.notifier, notification); 
} 
} 
Ё (non-Javadoc) 


* @see android.location.LocationListener#onProviderDisabled (java.lang.String) 
" 
@Override 
public void onProviderDisabled(String provider) { 
11 TODO Auto-generated method stub 


} 


/* (non-Javadoc) 
* @see android.location.LocationListener#onProviderEnabled (java.lang.String) 
sj 
@Override 
public void onProviderEnabled(String provider) { 
II TODO Auto-generated method stub 


} 


/* (non-Javadoc) 
* @see android.location.LocationListener#onStatusChanged(java.lang.String, int, android.os.Bundle) 
T 
@Override 
public void onStatusChanged(String provider, int status, Bundle extras) { 
11 TODO Auto-generated method stub 


} 


p 
* 从 路 径 P1 -> P2 获取 交叉 轨道 误差 的 PO 
*/ 


private double range(final GeoPoint ро, final GeoPoint p1, final GeoPoint p2) { 
double dist = Math.asin(Math.sin(p1 .distanceTo(p0)/BikeRouteConsts.EARTH_RADIUS) * 
Math.sin(p1.bearingTo(p0) - p1.bearingTo(p2))) * 
BikeRouteConsts.EARTH_RADIUS; 
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return Math.abs(dist); 


} 
19.3.2 ”线路 计划 监听 服务 


文件 RouteListenerjava 实现 线路 位 置 计划 监听 服务 ， 具 体 实 现代 码 如 下 所 示 。 
public interface RouteListener { 

public void searchComplete(Integer msg, Route route); 

public void searchCancelled(); 

public Context getContext(); 
} 


19.3.3 线路 任务 服务 


文件 RoutePlannerTask java 的 功能 是 显示 搜索 任务 和 计划 对 话 框 , 并 将 结果 过 渡 到 一 个 地 图 中 来 显 
示 路 径 。 文 件 RoutePlannerTask.java 的 具体 实现 代码 如 下 所 示 。 
public class RoutePlannerTask extends AsyncTask<Void, Void, Integer> { 
/** Route planner service consts. **/ 
public static final String PLAN TYPE = "plan type"; 
public static final int BIKE PLAN = 0; 
public static final int GEOPOINT PLAN = 1; 
public static final int REPLAN PLAN = 2; 
public static final int STANDS PLAN = 3; 
public static final int ADDRESS PLAN - 4; 
public static final String START ADDRESS - "start address"; 
public static final String END ADDRESS = "end address"; 
public static final String START. LOCATION = "start location"; 
public static final String END POINT = "end point"; 
public static final String ROUTE 10 = "route id"; 
private RouteManager planner; 
protected String startAddressInput; 
protected String endAddressInput; 
private RouteListener mAct; 
private Intent mintent; 
public RoutePlannerTask(RouteListener act, Intent intent) ( 
super(); 
mintent = intent; 
mAct = act; 
planner = new RouteManager(mAct.getContext()); 
} 
public void setListener(final RouteListener listener) { 
mAct = listener; 
} 
@Override 
protected void onPreExecute() { 
} 
@Override 
protected Integer dolnBackground(Void... arg0) { 
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int msg = R.id.plan_fail; 
planner.setRouteld(mintent.getintExtra(ROUTE_ ID, 0)); 
final String startAddressInput = mintent.getStringExtra(START_ADDRESS); 
final String endAddressInput = mintent.getStringExtra(END_ADDRESS); 
switch(mintent.getIntExtra(PLAN TYPE, ADDRESS PLAN)) { 
case ADDRESS_PLAN: 
if ("".equals(startAddressInput) || "".equals(endAddress|nput)) ( 
msg = R.id.argerror; 
) else { 
msg = R.id.result_ok; 
try ( 
planner.setStart(startAddressInput); 
planner.setDest(endAddressInput); 
} catch (Exception e) { 
msg = R.id.ioerror; 
} 
} 
break; 
case BIKE PLAN: 
final Parking prk = new Parking(mAct.getContext()); 
if ("".equals(startAddressInput)) { 
msg = R.id.argerror; 
) else { 
try( 
planner.setStart(startAddressInput); 
planner.setDest(prk.getLocation()); 
) catch (Exception e) ( 
msg = R.id.ioerror; 
} 
} 
break; 
case STANDS_PLAN: 
if ("".equals(startAddressInput)) { 
msg = R.id.argerror; 
) else { 
msg = R.id.result ok; 
try( 
planner.setStart(startAddressInput); 
planner.setDest(Stands.getNearest(planner.getStart(), mAct.getContext())); 
) catch (Exception e) ( 
msg = R.id.ioerror; 
) 
) 
break; 
case REPLAN_PLAN: 
final Location start = mintent.getParcelableExtra(START_LOCATION); 
final GeoPoint dest = mIntent.getParcelableExtra(END POINT); 
msg = R.id.result ok; 
planner.setStart(start); 
planner.setDest(dest); 
break; 
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default: 
msg = R.id.plan fail; 
} 
try ( 
if ((msg == R.id.result ok) && !planner.showRoute()) { 
msg = R.id.plan fail; 
} 
} catch (Exception e) { 
msg = R.id.ioerror; 
} 
return msg; 
} 
@Override 
protected void onPostExecute(final Integer msg) { 
mAct.searchComplete(msg, planner.getRoute()); 
} 


@Override 
protected void onCancelled() { 
mAct.searchCancelled(); 
super.onCancelled(); 
} 
} 


19.3.4 在 地 图 中 显示 行驶 线路 


文件 LiveRouteMap.java 的 功能 是 调用 19.3.1 节 到 19.3.3 节 中 的 3 个 导航 服务 , 根据 用 户 输入 的 起 始 
地 址 和 目标 地 址 ， 在 地 图 中 显示 对 应 的 线路 路 径 。 文 件 LiveRouteMap.java 的 具体 实现 代码 如 下 所 示 。 

public class LiveRouteMap extends SpeechRouteMap implements RouteListener { 

protected Intent searchintent; 

protected boolean mShownDialog; 

private RoutePlannerTask search; 

private boolean liveNavigation; 

private Segment lastSegment; 

private boolean spoken; 

private boolean arrived; 

private NavigationService mBoundService; 

private NavigationReceiver mBroadcastReceiver = new NavigationReceiver(); 

private ServiceConnection mConnection = new ServiceConnection() { 

public void onServiceConnected(ComponentName className, IBinder service) { 
mBoundService = ((NavigationService.LocalBinder)service).getService(); 


} 


public void onServiceDisconnected(ComponentName className) { 
mBoundService = null; 
} 
k 
private boolean mlsBound; 


@Override 
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public void onCreate(final Bundle savedState) { 
super.onCreate(savedState); 
//Handle rotations 
final Object[ ] data = (Object[ ]) getLastNonConfigurationInstance(); 
arrived = false; 
if (data != null) { 
isSearching = (Boolean) data[2]; 
search = (RoutePlannerTask) data[3]; 
if(search != null) { 
search.setListener(this); 
} 
spoken = (Boolean) data[4]; 
arrived = (Boolean) data[1]; 
} 
registerReceiver(mBroadcastReceiver, 
new IntentFilter(getString(R.string.navigation intent))); 
) 


@Override 
public Object onRetainNonConfigurationInstance() ( 
Object[ ] objs = new Object[5]; 
objs[0] = directions Visible; 
objs[1] = arrived; 
objs[2] = isSearching; 
objs[3] = search; 
objs[4] = spoken; 
return objs; 


} 


@Override 
public final boolean onPrepareOptionsMenu(final Menu menu) { 
final Menultem replan = menu.findltem(R.id.replan); 
final Menultem stopService = menu.findltem(R.id.stop nav); 
if (app.getRoute() != null) { 
replan.setVisible(true); 
} 
if (mlsBound) { 
stopService.setVisible(true); 
} 
return super.onPrepareOptionsMenu(menu); 
} 


@Override 
public void showStep() { 
super.showStep(); 
if(mSettings.getBoolean("gps", false)) { 
mLocationOverlay.followLocation(true); 
) else { 
mLocationOverlay.followLocation(false); 
} 
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@Override 
public void hideStep() { 
super.hideStep(); 
mLocationOverlay.followLocation(false); 
} 
private void replan() { 
isSearching = true; 
try { 
dismissDialog(R.id.plan fail); 
} catch (Exception e) { 
Log.e("Replanner", "Fail dialog not shown!"); 
} 
showDialog(R.id.plan); 


Location self = mLocationManager.getLastKnownLocation(LocationManager.GPS PROVIDER); 


if (self == null) ( 
self - mLocationOverlay.getLastFix(); 
} 
if (self == null) { 
self = mLocationManager.getLastKnownLocation(LocationManager.NETWORK PROVIDER); 
} 
if (self != null) { 
searchintent = new Intent(); 
searchintent.putExtra(RoutePlannerTask.ROUTE_ID, app.getRoute().getRouteld()); 
searchintent.putExtra(RoutePlannerTask.PLAN TYPE, RoutePlannerTask.REPLAN PLAN); 
searchintent.putExtra(RoutePlannerTask.START LOCATION, self); 
searchintent.putExtra(RoutePlannerTask.END POINT, 
app.getRoute().getPoints().get(app.getRoute().getPoints().size() - 1)); 
LiveRouteMap.this.search = new RoutePlannerTask(LiveRouteMap.this, searchIntent); 
LiveRouteMap.this.search.execute(); 
) else { 
dismissDialog(R.id.plan); 
showDialog(R.id.plan_fail); 


@Override 
public Dialog onCreateDialog(final int id) { 
Dialog dialog; 
AlertDialog. Builder builder; 
switch(id) { 
case R.id.gps: 
builder = new AlertDialog.Builder(this); 
builder.setMessage(R.string.gps msg); 
builder.setCancelable(false); 
builder.setPositiveButton(getString(R.string.ok), 
new DialogInterface.OnClickListener() { 
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@Override 
public void onClick(final DialogInterface dialog, 
final int id) { 
showGpsOptions(); 
} 
y 
builder.setTitle(R.string.gps msg title); 
dialog 7 builder.create(); 
break; 
case R.id.plan: 
ProgressDialog pDialog = new ProgressDialog(this); 
pDialog.setCancelable(true); 
pDialog.setProgressStyle(ProgressDialog.STYLE_SPINNER); 
pDialog.setMessage(getText(R.string.plan msg)); 
pDialog.setOnDismissListener(new OnDismissListener() ( 
@Override 
public void onDismiss(final Dialoglnterface arg0) { 
removeDialog(R.id.plan); 


} 
}); 


pDialog.setOnCancelListener(new OnCancelListener() { 


@Override 
public void onCancel(final DialogInterface arg0) { 
if (search != null) { 
search.cancel(true); 


} 
isSearching = false; 


) 
dialog = pDialog; 
break; 
case R.id.plan fail: 
builder = new AlertDialog.Builder(this); 
builder.setMessage(R.string.planfail msg); 
builder.setCancelable( 
true).setPositiveButton(getString(R.string.ok), 
new DialogInterface.OnClickListener() { 
@Override 
public void onClick(final DialogInterface dialog, 
final int id) { 
} 
ys 
dialog = builder.create(); 
break; 
default: 
dialog = super.onCreateDialog(id); 
} 
return dialog; 
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@Override 
public boolean onOptionsltemSelected(final Menultem item) { 
switch (item.getltemld()) { 
case R.id.replan: 
if (!mlsBound) ( 
doBindService(); 
} 
replan(); 
break; 
case R.id.stop_nav: 
doUnbindService(); 
this.finish(); 
break; 
case R.id.turnbytum: 
spoken = true; 
default: 
return super.onOptionsltemSelected(item); 
} 
return true; 
} 
private void doBindService() { 
bindService(new Intent(LiveRouteMap.this, 
NavigationService.class), mConnection, Context.BIND AUTO CREATE); 
mlsBound = true; 
} 
private void doUnbindService() { 
if (mlsBound) { 
11 Detach our existing connection 
unbindService(mConnection); 
mlsBound = false; 
} 
} 
@Override 
public void onDestroy() { 
super.onDestroy(); 
doUnbindService(); 
unregisterReceiver(mBroadcastReceiver); 
} 
@Override 
public void onStart() { 


super.onStart(); 
liveNavigation = mSettings.getBoolean("gps", false); 
if (app.getRoute() != null) { 
//Disable live navigation for non GB routes to comply with Google tos 
liveNavigation = !"GB".equals(app.getRoute().getCountry()) ? false : liveNavigation; 
if (tts && directionsVisible && lisSearching) { 
speak(app.getSegment()); 
lastSegment = app.getSegment(); 
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} 
if (liveNavigation) ( 
if(ImLocationManager.isProviderEnabled(LocationManager.GPS PROVIDER)) { 
showDialog(R.id.gps); 
} 
doBindService(); 
) else { 
doUnbindService(); 
) 


private class NavigationReceiver extends BroadcastReceiver ( 


Ё (non-Javadoc) 
* @see android.content.BroadcastReceiver#onReceive(android.content.Context, android.content.Intent) 
*l 
@Override 
public void onReceive(Context context, Intent intent) { 
if (liveNavigation && directionsVisible && !arrived && lisSearching) { 
if (intent.getBooleanExtra(getString(R.string.replan), false)) { 
isSearching = true; 
replan(); 
} else if (intent.getBooleanExtra(getString(R.string.arrived), false)) { 
arrive(); 
spoken = true; 
) else { 
GeoPoint current = (GeoPoint) intent.getExtras().get(getString(R.string.point)); 
if (lapp.getSegment().equals(lastSegment)) { 
lastSegment = app.getSegment(); 
spoken = false; 
} 


//Get next point 

Listlterator«GeoPoint» it = app.getRoute().getPoints().listlterator( 
app.getRoute().getPoints().indexOf(current) + 1); 

GeoPoint next = it.hasNext() ? it.next() : current; 


IISpeak directions if the next point is a new segment 

lland have not spoken already 

if (Ispoken && !app.getSegment().equals(app.getRoute().getSegment(next)) && tts) { 
speak(app.getRoute().getSegment(next)); 
spoken = true; 

} 

showStep(); 

traverse(current); 
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} 
@Override 
public void searchComplete(Integer msg, Route route) ( 
try ( 
dismissDialog(R.id.plan); 
} catch (Exceptione) { 
} 
isSearching = false; 
if (msg != null) { 
if (msg == R.id.result_ok) { 
app.setRoute(route); 
app.setSegment(app.getRoute().getSegments().get(0)); 
mOsmv.getController().setCenter(app.getSegment().startPoint()); 
traverse(app.getSegment().startPoint()); 
arrived = false; 
if (directionsVisible) ( 
showStep(); 
if (tts) { 
speak(app.getSegment()); 
spoken = true; 
} 
} 
) else { 
showDialog(msg); 
) 
} 
} 
@Override 


public void searchCancelled() { 
isSearching = false; 


search = null; 

} 

private void arrive() { 
doUnbindService(); 
arrived = true; 


app.setSegment(app.getRoute().getSegment(app.getRoute().getEndPoint())); 
traverse(app.getRoute().getEndPoint()); 
showStep(); 
if (tts) { 
directionsTts.speak(getString(R.string.arrived_speech), TextToSpeech.QUEUE ADD, null); 
} 
} 


private void showGpsOptions() { 
startActivity(new Intent( 
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android.provider. Settings.ACTION_LOCATION_SOURCE_SETTINGS)); 


19.3.5 生成 导航 视图 


文件 DirectionsView.java 的 功能 是 , 根据 用 户 输入 的 地 址 参数 生成 导航 视图 ， 能够 根据 用 户 的 选择 
显示 不 同 的 视图 界面 ， 例 如 地 图 界面 、 关 于 我 们 、 海拔 、 首 选 设置 项 等 。 文 件 DirectionsView.java 的 具 
体 实现 代码 如 下 所 示 。 
public class DirectionsView extends ListActivity { 
/** Route object. **/ 
private Route route; 
/** Units. **/ 
private String unit; 
private TextView header; 
private TextView footer; 


@Override 
public void onCreate(final Bundle in) { 


} 


requestWindowFeature(Window.FEATURE RIGHT ICON); 
setFeatureDrawableResource(Window.FEATURE RIGHT ICON, R.drawable.ic bar bikeroute); 
super.onCreate(in); 

//Create a header to display route distance 

header 7 new TextView(this); 

getListView().addHeaderView(header, "", false); 

//Create a footer to display warnings & copyrights 

footer = new TextView(this); 

getListView().addFooterView(footer, "", false); 

//Add the list of directions and set it filterable 

setListAdapter(new DirectionListAdapter(this, R.layout.direction item)); 
getListView().setTextFilterEnabled(true); 


@Override 
public void onStart() { 


super.onStart(); 
final SharedPreferences settings = PreferenceManager.getDefaultSharedPreferences(this); 
unit = settings.getString(getString(R.string.prefs_units), getString(R.string.km)); 


route = ((BikeRouteApp)getApplication()).getRoute(); 
setTitle(route.getName()); 


//Create a header for the list 

StringBuffer sBuf = new StringBuffer("Total distance: "); 

if (getString(R.string.km).equals(unit)) { 
sBuf.append(Convert.asMeterString(route.getLength())); 
sBuf.append(" ("); 
sBuf.append(Convert.asKilometerString(route.getLength())); 
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sBuf.append(')’); 

}else { 
sBuf.append(Convert.asFeetString(route.getLength())); 
sBuf.append(" ("); 
sBuf.append(Convert.asMilesString(route.getLength())); 
sBuf.append()); 

} 

header.setText(sBuf.toString()); 


sBuf = new StringBuffer(); 

if (route.getWarning() != null) { 
sBuf.append(route.getWaming()); 
sBuf.append(‘\n'); 

} 

if (route.getCopyright() != null) { 
sBuf.append(route.getCopyright()); 

} 

footer.setText(sBuf.toString()); 

((DirectionListAdapter) getListAdapter()).populate(); 

} 


@Override 
protected void onListltemClick(final ListView |, final View v, 
final int position, final long id) { 
((BikeRouteApp)getApplication()). 
setSegment(route.getSegments().get(position -1)); 
final Intent intent = new Intent(this, LiveRouteMap.class); 


intent.putExtra(getString(R.string.jump intent), true); 
startActivity(intent); 
) 


p 
* 创建 选项 菜单 
* @retum true if menu created. 
f 
@Override 
public final boolean onCreateOptionsMenu(final Menu menu) { 
final Menulnflater inflater = getMenulnflater(); 
inflater.inflate(R.menu.directions_menu, menu); 
return true; 


} 


p 
* 根 据 用 户 的 选择 来 到 不 同 的 视图 界面 
T 
@Override 
public boolean onOptionsltemSelected(final Menultem item) ( 
Intent intentDir = null; 
switch (item.getltemld()) { 
case R.id.navigate: 
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intentDir = new Intent(this, Navigate.class); 
break; 
case R.id.map: 
intentDir = new Intent(this, LiveRouteMap.class); 
break; 
case R.id.prefs: 
intentDir = new Intent(this, Preferences.class); 
break; 
case R.id.about: 
showDialog(R.id.about); 
return true; 
case R.id.elevation: 
XYMultipleSeriesDataset elevation = route.getElevations(); 
final XYMultipleSeriesRenderer renderer = route.getChartRenderer(); 
if (IgetString(R.string.km).equals(unit)) ( 
elevation = Convert.aslmperial(elevation); 
renderer.setYTitle(getString(R.string.ft)); 
renderer.setXTitle(getString(R.string.meters)); 
} 
renderer.setYAxisMax(elevation.getSeriesAt(0).getMaxY() + 200); 
intentDir = ChartFactory.getLineChartintent(this, elevation, renderer); 
} 
startActivity(intentDir); 
return true; 


} 


p 
“创建 对 话 框 界面 
У) 


@Override 
public Dialog onCreateDialog(final int id) { 
final AlertDialog.Builder builder = new AlertDialog.Builder(this); 
builder.setMessage(getText(R.string.about message)).setCancelable( 
true).setPositiveButton(getString(R.string.ok), 
new DialogInterface.OnClickListener() { 
@Override 
public void onClick(final DialogInterface dialog, 
final int id) { 
dialog.dismiss(); 
} 
y 


return builder.create(); 


} 

导航 视图 界面 对 应 的 布局 文件 是 direction item.xml， 有 具体 实现 代码 如 下 所 示 。 

<RelativeLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout_height="?android:attr/listPreferreditemHeight" 
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android:background="#ffffffff" 
android:padding="6dip" 
android:id="@+id/directions_item"> 
<TextView 
android:id="@-+id/turn" 
android:layout widthz"fill parent" 
android:layout height-"wrap content" 
android:textSize="18px" 
android:textColor="#000000" 
android:text="Road and turn." /> 
<TextView 
android:id="@+id/length" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:textSize="10px" 
android:textColor="#5E72F7" 


android:text="Length of step (total distance in km)" 


android:layout_below="@id/turn" /> 
<TextView 
android:id="@+id/distance" 
android:layout_width="wrap_content" 
android:layout height="wrap content" 
android:textSize="10px" 
android:textColor="#49D611" 
android:paddingLeft="5px" 


android:text="Length of step (total distance in km)" 


android:layout_toRightOf="@id/length" 
android:layout_below="@id/turn" /> 


</RelativeLayout> 
路 径 导 航 视 图 界面 的 执行 效果 如 图 19-2 所 示 。 
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19-2 路 径 导 航 视 图 界面 
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М 知识 点 讲解 光盘 :视频 \ 知 识 点 \ 第 19 章 \ 街 道 分 析 .avi 

为 了 实现 精准 的 线路 规划 和 定位 ， 本 实例 借助 http://www.cyclestreets.net/ 提 供 的 街道 数据 ， 这 样 在 
规划 线路 时 可 以 为 我 们 构建 更 加 精准 的 骑 行 线路 。 街 道 分 析 功 能 的 实现 文件 是 CycleStreetsParserjava, 
功能 是 建立 和 CycleStreetsParser АРІ 的 连接 ， 构 建 XML 街道 数据 。 文 件 CycleStreetsParser java 的 具体 
实现 代码 如 下 所 示 。 

public class CycleStreetsParser extends XMLParser implements Parser { 


/** Distance covered. **/ 
private double distance; 


public CycleStreetsParser(final String feedUrl) { 
super(feedUrl); 
} 


public final Route parse() { 
final Segment segment = new Segment(); 
final Route route = new Route(); 
route.setCopyright("Route planning by CycleStreets.net"); 
final RootElement root new RootElement(MARKERS); 
final Element marker = root.getChild(MARKER); 
II Listen for start of tag, get attributes and set them 
II on current marker 
marker.setStartElementListener(new StartElementListener() ( 
public void start(final Attributes attributes) ( 
segment.clearPoints(); 
GeoPoint p; 


final String pointString = attributes.getValue("points"); 
final String nameString = attributes.getValue("name"); 
String turnString = attributes. getValue("turn"); 

final String type = attributes.getValue("type"); 

final String walk = attributes. getValue("walk"); 

final String length = attributes.getValue("distance"); 
final String totalDistance = attributes.getValue("length"); 
final String elev = attributes.getValue("elevations"); 
final String distances = attributes.getValue("distances"); 
final String id = attributes.getValue("itinerary"); 


/* Parse segment. **/ 


if 'segment" equals(type)) ( 
StringBuffer sBuf = new StringBuffer(); 
if (l'unknown".equals(tumString)) ( 
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sBuf.append(Character.toUpperCase( 
turnString.charAt(0)) + tumString.substring(1)); 

sBuf.append(" at "); 

} 

sBuf.append(nameString); 

sBuf.append(' '); 

if ("1".equals(walk)) { 
sBuf.append("(dismount)"); 

} 

segment.setinstruction(sBuf.toString()); 


final String[ ] pointsArray = pointString.split(" ", -1); 
final String[ ] elevations = elev.split(",", -1); 
final String[ ] dists = distances.split(",", -1); 


//Add elevations to the elevation/distance series 
for (int i = 0; i « dists.length; i++) ( 
int len = Integer.parselnt(dists[i]); 
int elevation = Integer.parselnt(elevations[i]); 
distance += len; 
route.addElevation(elevation, distance); 
) 


final int len = pointsArray.length; 
for (inti = 0; i < len; i++) ( 
final String[ ] point = pointsArray[i].split(",", -1); 
p = new GeoPoint(Convert.asMicroDegrees(Double.parseDouble(point[1])), 
Convert.asMicroDegrees(Double.parseDouble(point(0]))); 
route.addPoint(p); 
segment.addPoint(p); 
} 
segment.setDistance(distance/1000); 
segment.setLength(Integer.parselnt(length)); 


}else { 
/** Parse route details. **/ 
route.setName(nameString); 
route.setLength(Integer.parselnt(totalDistance)); 
route.setltineraryld(Integer.parselnt(id)); 


} 
y 
marker.setEndElementListener(new EndElementListener() { 
public void end() { 
if (segment.getinstruction() != null) { 
route.addSegment(segment.copy()); 
} 
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ys 
try { 
Xml.parse(this.getInputStream(), Xml.Encoding.UTF 8, root 
.getContentHandler()); 
) catch (Exception e) ( 
Log.e(e.getMessage(), "CycleStreets parser - " + feedUrl); 
return null; 


} 
lIroute.buildTree(); 
return route; 


19.5. 海拔 数据 分 析 


知识 点 讲解 :光盘 :视频 \ 知 识 点 第 19 BREDA avi 

为 了 实时 测量 不 同 线路 上 各 个 地 点 的 海拔 数据 ， 在 本 实例 中 使 用 了 Google Elevation API 技术 。 
Google Elevation API 为 开发 者 提供 了 查询 地 球 上 某 位 置 的 海拔 数据 的 简单 接口 。 此 外 ， 还 可 以 请 求 对 
沿途 的 海拔 数据 进行 抽样 ， 以 便 计 算 沿 途 路 线 的 海拔 变化 。 本 实例 实现 海拔 测量 功能 的 实现 文件 是 
GoogleElevationParserjava， 有 具体 实现 代码 如 下 所 示 。 

public class GoogleElevationParser extends XMLParser implements Parser { 


private double distance; 
private final Route route; 


public GoogleElevationParser(final String feedUrl, final Route route) { 
super(feedUrl); 
this.route = route; 


public Route parse() ( 
II turn the stream into a string 
final String result = convertStreamToString(this.getInputStream()); 
try { 
I[Tranform the string into a json object 
final JSONObject json = new JSONObject(result); 
//Get the results object 
final JSONArray jsonResult = json.getJSONArray("results"); 
JSONObject location = jsonResult.getJSONObject(0).getJSONObject("location"); 
//Get the first point, use it as a basis for calculating the distance 
//Store incremented distance with retrieved elevation. 
double lastLat = location.getDouble("lat"); 
double lasting = location.getDouble("Ing"); 
for (int i = 0; i « jsonResult.length(); i++) ( 
location = jsonResult.getJSONObject(i).getJ SONObject("location"); 
final double lat = location.getDouble("lat"); 
final double Ing = location.getDouble("Ing"); 
final double elevation = jsonResult.getJSONObject(i).getDouble("elevation"); 
distance += pointDiff(lat, Ing, lastLat, lastLng); 
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lastLat = lat; 
lastLng = Ing; 
route.addElevation(elevation, distance); 
} 
} catch (JSONException e) { 
Log.e(e.getMessage(), "Google JSON Parser - " + feedUrl); 
} 
return route; 


private static String convertStreamToString(final InputStream input) { 
final BufferedReader reader = new BufferedReader(new InputStreamReader(input)); 
final StringBuilder sBuf = new StringBuilder(); 


String line = null; 
try( 
while ((line = reader.readLine()) != null) ( 
sBuf.append(line); 
} 
} catch (IOException e) ( 
Log.e(e.getMessage(), "Google parser, stream2string"); 
} finally { 
try { 
input.close(); 
} catch (IOException e) { 
Log.e(e.getMessage(), "Google parser, stream2string"); 
} 
} 
return sBuf.toString(); 
} 


private double pointDiff(final double lat, final double Ing, final double latA, final double IngA) { 
final double dLat = Math.toRadians(latA - lat); 
final double dLon = Math.toRadians(IngA - Ing); 
final double a = Math.sin(dLat / 2) * Math.sin(dLat / 2) + 
Math.cos(Math.toRadians(lat)) * Math.cos(Math.toRadians(latA)) * 
Math.sin(dLon / 2) * Math.sin(dLon / 2); 
final double c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a)); 
return BikeRouteConsts.EARTH RADIUS * c * 1000; 
} 
} 
到 此 为 止 ， 本 实例 的 核心 功能 全 部 讲解 完毕 。 至 于 其 他 模块 的 具体 实现 ， 因 与 本 书 中 前 面 的 内 容 


有 所 重复 ， 为 了 节省 篇 幅 ， 将 不 再 详细 讲解 ， 读 者 只 需 阅 读本 书 附带 光盘 中 的 源码 文件 即 可 。 


622 


